Do the test items added via Add-TestData expire automatically?

Yes. By default, items added using the Add-TestData cmdlet have an absolute expiration of 300 seconds (5 minutes). This prevents test data from permanently occupying cache memory.

Is authentication required to run the Add-TestData command?

Authentication is required if NCache security is enabled. On Windows, use the -Credentials parameter; on Linux CLI, provide the -userid and -password parameters to authorize the operation.

What is the primary use case for Add-TestData in NCache?

The primary use case is cluster health verification. It allows developers to confirm that the cache is started, accessible over the network, and correctly distributing items across nodes.

Can I specify a custom object size for NCache stress testing?

Yes, you can use the -DataSize parameter to define the size of each test item in bytes, allowing you to simulate heavy payloads and benchmark cache performance.

Add-TestData

The Add-TestData PowerShell cmdlet allows users to efficiently add random test data to the cache for performance testing, verification, and simulation. By adding configurable key-value pairs with absolute expiration (default 300 seconds), this tool is ideal for cache startups, load testing, and benchmarking. Users can customize the number of items, data size, and expiration time to meet specific testing needs. It supports single or multiple servers and secure authentication, ensuring flexible integration and reliable performance checks.

Windows PowerShell
Linux CLI

Add-TestData -CacheName [-Server] [-ItemCount] [-DataSize] [-AbsoluteExpiration] [-NoLogo] [-Credentials]

Examples

This command adds 10 items (it is set to 10 by default) to the demoCache with an expiry of 5 minutes.

Add-TestData –CacheName demoCache

This command adds 100 items to the demoCache with an expiry of 5 minutes.

Add-TestData -CacheName demoCache -ItemCount 100

This command adds 100 items of size 2KB to the demoCache with an expiry of 5 minutes.

Add-TestData -CacheName demoCache -ItemCount 100 -DataSize 2048

This command adds 100 items to the demoCache with an expiry of 5 minutes.

Add-TestData -CacheName demoCache -ItemCount 100 -Server "20.200.20.11,20.200.20.12"

This command adds 10 items (it is set to 10 by default) to the demoCache with an expiry of 5 minutes, using security credentials.

Add-TestData –CacheName demoCache -Credentials(Get-Credential john_smith)

Properties

Note

The parameters with asterisk (*) on their names are the required parameters and the rest are optional.

Parameters	Data Types	Description	Default Value
`-CacheName*`	`<String>`	Specifies the name of the cache to which test data will be added. Note: The cache must already exist on the source server.	-
`-Server`	`<String>`	Specifies a server name where the NCache Service is running and a cache with the specified cache-name is registered. You can also specify one or more ip-address(es) for one or more cache-server(s) to customize the list of ip-address(es) to be displayed. Note: Comma separated ip-addresses are to be specified in case of multiple servers inside double quotes.	IP of local machine
`-ItemCount`	`<Long>`	Specifies the number of test items to be added to the cache.	10
`-DataSize`	`<Long>`	Specifies the size of each item to be added to the cache.	1024 bytes
`-AbsoluteExpiration`	`<Double>`	Specifies the time in seconds for the Absolute expiration of the test data items. Its minimum value is 15 seconds.	300 seconds
`-NoLogo`	`<SwitchParameter>`	Suppresses display of the logo banner.	False
`-Credentials`	`<pscredential>`	Specifies the user credentials required to authorize access for the specified operation. These credentials should belong to a user with the appropriate permissions at the node.	-

add-testdata -cachename [-server] [-itemcount] [-datasize] [-absoluteexpiration] [-nologo] [-userid] [-password]

Examples

This command adds 10 items (it is set to 10 by default) to the demoCache with an expiry of 5 minutes.

add-testdata –cachename demoCache

This command adds 100 items to the demoCache with an expiry of 5 minutes.

add-testdata -cachename demoCache -itemcount 100

This command adds 100 items of size 2KB to the demoCache with an expiry of 5 minutes.

add-testdata -cachename demoCache -itemcount 100 -datasize 2048

This command adds 100 items to the demoCache with an expiry of 5 minutes.

add-testdata -cachename demoCache -itemcount 100 -server "20.200.20.11,20.200.20.12"

This command adds 10 items (it is set to 10 by default) to the demoCache with an expiry of 5 minutes, using security credentials.

add-testdata –cachename demoCache -userid john_smith -password pass123

Properties

Note

The parameters with asterisk (*) on their names are the required parameters and the rest are optional.

Parameters	Data Types	Description	Default Value
`-cachename*`	`<String>`	Specifies the name of the cache to which test data will be added. Note: The cache must already exist on the source server.	-
`-server`	`<String>`	Specifies a server name where the NCache Service is running and a cache with the specified cache-name is registered. You can also specify one or more ip-address(es) for one or more cache-server(s) to customize the list of ip-address(es) to be displayed. Note: Comma separated ip-addresses are to be specified in case of multiple servers inside double quotes.	IP of local machine
`-itemcount`	`<Long>`	Specifies the number of test items to be added to the cache.	10
`-datasize`	`<Long>`	Specifies the size of each item to be added to the cache.	1024 bytes
`-absoluteexpiration`	`<Double>`	Specifies the time in seconds for the Absolute expiration of the test data items. Its minimum value is 15 seconds.	300 seconds
`-nologo`	`<SwitchParameter>`	Suppresses display of the logo banner.	False
`-userid`	`<String>`	Specifies the user id used to authorize the user for this operation. It is required in case security is enabled on Cache Server. This user id must be the active directory user id.	-
`-password`	`<String>`	Specifies the password of the user that is used to authorize the user for this operation. It is required in case security is enabled on Cache Server. This password must be the same as the active directory user password.	-

Add-TestData

Examples

Properties

Note

Contact Us