How does Import-CacheData handle existing items in the cache?

If an item from the backup already exists in the target cache, Import-CacheData will overwrite it, ensuring the cache state is synchronized with the backup data.

When should I use 'Adjusted' expiry during an import?

Use 'Adjusted' expiry when you want the items' Time-to-Live (TTL) to be recalculated starting from the moment they are imported, preventing immediate expiration of old backup data.

What is the role of BulkSize in the import process?

BulkSize determines how many items are sent to the cache in a single internal operation. Increasing this value improves restoration throughput but increases memory usage on the target nodes.

Import-CacheData

Import-CacheData is designed to populate NCache clusters from offline backups created via the Export-CacheData cmdlet. It is an essential for disaster recovery and cluster migration, and uses bulk-inserts to any performance restoration overhead. Additionally, administrators can ensure data integrity and consistency when re-populating distributed caches across diverse server environments by configuring Error Thresholds and Expiration Policies.

Windows PowerShell
Linux CLI

Import-CacheData -Name [-Server] -Path [-BulkSize] [-ErrorThreshhold] [-Expiry] [-NoLogo] [-Credentials]

Examples

This command reloads all the items to the cache from the path specified.

Import-CacheData -Name demoCache -Path C:\Backup-path

This command reloads all the items to the cache from the path specified and will exit if 10 errors occur during the process.

Import-CacheData -Name demoCache -Path C:\Backup-path –ErrorThreshhold 10

This command reloads all the items in bulk of 100 to the cache from the path specified.

Import-CacheData -Name demoCache -Path C:\Backup-path -BulkSize 100

This command reloads all the items to the cache on server 20.200.20.11 from the path specified.

Import-CacheData -Name demoCache -Path C:\Backup-path -Server 20.200.20.11

This command reloads all the items to the cache from the path specified, using security credentials.

Import-CacheData -Name demoCache -Path C:\Backup-path -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
`-Name*`	`<String>`	Specifies the name of the cache which is to be backed up or restored. 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.	IP of local machine
`-Path*`	`<String>`	Specifies the path where the backup data is currently present.	-
`-BulkSize`	`<Long>`	Specifies the bulk insertion size that can be restored back to the cache at one time.	1000
`-ErrorThreshold`	`<Long>`	Specifies the number of errors that can be tolerated during importing files from the backup.	1
`-Expiry`	`<String>`	Specifies the expiration policy that gives the time span of the expiry of the data that is restored to the cache. The Possible options are - None - Adjusted - AsBefore	Adjusted
`-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.	-

import-cachedata -name [-server] -path [-bulksize] [-errorthreshhold] [-expiry] [-nologo] [-userid] [-password]

Examples

This command reloads all the items to the cache from the path specified.

import-cachedata -name demoCache -path C:\Backup-path

This command reloads all the items to the cache from the path specified and will exit if 10 errors occur during the process.

import-cachedata -name demoCache -path C:\Backup-path –errorthreshhold 10

This command reloads all the items in bulk of 100 to the cache from the path specified.

import-cachedata -name demoCache -path C:\Backup-path -bulksize 100

This command reloads all the items to the cache on server 20.200.20.11 from the path specified.

import-cachedata -name demoCache -path C:\Backup-path -server 20.200.20.11

This command reloads all the items to the cache from the path specified, using security credentials.

import-cachedata -name demoCache -path C:\Backup-path -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
`-name*`	`<String>`	Specifies the name of the cache which is to be backed up or restored. 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.	IP of local machine
`-path*`	`<String>`	Specifies the path where the backup data is currently present.	-
`-bulksize`	`<Long>`	Specifies the bulk insertion size that can be restored back to the cache at one time.	1000
`-errorthreshold`	`<Long>`	Specifies the number of errors that can be tolerated during importing files from the backup.	1
`-expiry`	`<String>`	Specifies the expiration policy that gives the time span of the expiry of the data that is restored to the cache. The Possible options are - None - Adjusted - AsBefore	Adjusted
`-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.	-
`-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.	-

Import-CacheData

Examples

Properties

Note

Contact Us