Remove-ClientCacheRefDataType
This PowerShell cmdlet enables users to remove pre-configured reference data types for Full-Data Client Cache.
Remove-ClientCacheRefDataType -CacheName [-Datatype] `
[-NoLogo] [-Port] `
[-Server] [-Credentials] `
[-TlsCertPath] [-TlsCertPassword]
Examples
- This command removes the class Data.Customer as reference data type for Full-Data Client Cache configured for defaultCache.
Remove-ClientCacheRefDataType -CacheName defaultCache -Datatype Data.Customer
- This command removes the classes Data.Customer and Data.Product as reference data types for Full-Data Client Cache configured for defaultCache on the server 20.200.20.11.
Remove-ClientCacheRefDataType -CacheName defaultCache -Datatype Data.Customer'$'Data.Product `
-Server 20.200.20.11
- This command removes the class Data.Customer as reference data type for Full-Data Client Cache configured for defaultCache on the local server using security credentials.
Remove-ClientCacheRefDataType -CacheName defaultCache -Datatype Data.Customer `
-Credentials(Get-Credential john_smith)
- This command removes the classes Data.Customer and Data.Product as reference data types from the Full-Data Client Cache configured for defaultCache on server 20.200.20.11 using a client PEM certificate and password for mutual TLS (mTLS) authentication.
Remove-ClientCacheRefDataType -CacheName defaultCache -Datatype Data.Customer'$'Data.Product `
-Server 20.200.20.11 -TlsCertPath "C:\certs\client.pem" `
-TlsCertPassword "clientKeyPassword"
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 clustered cache with which the Full-Data Client Cache is configured. | - |
-Datatype |
<String> |
Specifies the names of the reference data types configured for Full-Data Client Cache. Multiple data types should be '$' separated e.g., Data.Customer'$'Data.Product. | - |
-Port |
<Integer> |
Specifies the server port where NCache Service is listening. | 9803 |
-Server |
<String> |
Specifies the name or IP address of the NCache server where the clustered cache is registered. | IP of local machine |
-Credentials |
<pscredential> |
Specifies the user credentials used to authorize the user for this operation. It is required in case security is enabled on cache server. The password must be the same as the active directory user password. The user id must be the same as the active directory user id. | - |
-TlsCertPath |
<String> |
Specifies the path to a client PEM certificate for mTLS authentication. The PEM file must contain the private key, leaf certificate, and any intermediate certificates. This is required when running the PowerShell module from a machine without NCache installed and connecting to a server that requires mTLS. On an NCache server installation, the node's own certificate is used automatically. Relative paths are resolved from the current PowerShell location. A certificate can be generated using New-NCacheTlsCertificate. |
- |
-TlsCertPassword |
<String> |
Specifies the password for the encrypted private key in the PEM file provided through -TlsCertPath. Omit this parameter if the private key is not encrypted. The password is used only for the current command and is not saved in the NCache server configuration. |
- |
-NoLogo |
<SwitchParameter> |
Suppresses display of the logo banner. | False |