Add-CacheSecurity
Note
This feature is only available in NCache Enterprise Edition.
Add-CacheSecurity cmdlet enables the user to configure cache level security
for the cache. This allows the following operations:
Add new users
Remove user
Enable security for cache.
Disable security for cache.
Add-CacheSecurity [-Name] [-AddUser] [-RemoveUser] [-DisableSecurity] [-DomainController] [-EnableSecurity] [-NewUser] [-NewUserPassword] [-NoLogo] [-Password] [-Server] [-UserId] [-NewUserDN] [-DomainControllerPort]
These properties are explained in detail in the Properties section.
Examples
- The following command adds new user david_watson to demoCache's user list where user id is john_smith
Add-CacheSecurity -AddUser -UserID john_smith -Password mypassword -NewUser david_watson -NewUserDN "CN=David Watson,OU=admin,DC=yourdomain,DC=org " -NewUserPassword userpassword -DomainController yourdomain.org -DomainControllerPort 389 -Server 20.200.20.11 -Name demoCache
- The following command deletes a user david_watson from demoCache where user id is john_smith
Add-CacheSecurity -RemoveUser -UserID john_smith -Password mypassword -DeleteUser david_watson -DomainController yourdomain.org -DomainControllerPort 389 -Server 20.200.20.11 -Name demoCache
- The following command enables security for user john_smith on demoCache.
Add-CacheSecurity -EnableSecurity -UserID john_smith -Password mypassword -DomainController yourdomain.org -DomainControllerPort 389 -Server 20.200.20.11 -Name demoCache
- The following command disables security for user john_smith on demoCache.
Add-CacheSecurity -DisableSecurity -UserID john_smoth -Password mypassword -DomainController yourdomain.org -DomainControllerPort 389 -Server 20.200.20.11 -Name demoCache
Properties
Note: The parameters with an asterisk (*) with 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 for which security will be configured. | - |
-Server* |
<String> |
Specifies the server node on which NCache service is running. | IP of local machine |
-DomainController* |
<String> |
Specifies the domain controller for the users. | - |
-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 LDAP user-id prefixed with the domain name. | - |
-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 LDAP directory user password. | - |
-EnableSecurity |
<SwitchParameter> |
Specifies that the cmdlet is being used for enabling security on a specific cache. | - |
-DisableSecurity |
<SwitchParameter> |
Specifies that the cmdlet is being used for disabling security on a specific cache. | - |
-AddUser |
<SwitchParameter> |
Specifies that the cmdlet is being used for adding a user to cache's users list. | - |
-DeleteUser |
<String> |
Specifies the existing user which is now being deleted or removed from NCache cache users. | - |
-NewUser |
<String> |
Specifies the user name to add. | - |
-NewUserDN |
<String> |
Specifies the new user's distinguished name. | - |
-NewUserPassword |
<String> |
Specifies the new user's password. | - |
-RemoveUser |
<SwitchParameter> |
Specifies that the cmdlet is being used for removing a user from NCache cache users. | - |
-DomainController Port |
<Integer> |
Specifies the port on which domain controller is running. | 389 |
-NoLogo |
<SwitchParameter> |
Suppresses display of the logo banner. | - |