Reconfiguring Cache Cluster Settings (Windows Server AppFabric Caching)

The cache cluster configuration settings control the behavior of the whole cache cluster. This includes properties such as the cache hosts that make up the cluster, which of those hosts are lead hosts, and the security model used for the cluster. Use the Export-CacheClusterConfig Windows PowerShell command to view the current cache cluster settings.

Export-CacheClusterConfig -File "c:\CacheClusterConfig.xml"

After making any necessary changes to the configuration, you can apply the changes with the Import-CacheClusterConfig command.

Import-CacheClusterConfig -File "C:\CacheClusterConfig.xml"

The cache cluster configuration file does not always show settings that maintain default values. For example, if you use default security settings, you may not have an advancedProperties element that has a securityProperties child element. But if you disable security with the Set-CacheClusterSecurity command, you would then see the following non-default values displayed in the configuration file:

<advancedProperties>
   <securityProperties mode="None" protectionLevel="None" />
</advancedProperties>

Note that some settings, such as the size of the cache cluster, can be set only by using the Export-CacheClusterConfig and Import-CacheClusterConfig commands. Other cache cluster settings, such as security, can also be modified with specific Windows PowerShell commands.

Note

Cluster-level changes require downtime of the whole cache cluster. Before using the Import-CacheClusterConfig command, you must first stop the cache cluster with the Stop-CacheCluster command.

For more information, see Configuring the Cache Cluster.

See Also

Concepts

Common Cache Cluster Management Tasks (Windows Server AppFabric Caching)