Remove-NCacheUserOrGroup
This PowerShell Cmdlet removes a user or group from the NCache security configuration. It allows you to specify the server, user or group name, access level, cache name (if applicable), administrative credentials, and disable security. The cmdlet verifies the user's credentials, evaluates the access level, and then removes the specified user or group as required.
Remove-NCacheUserOrGroup [-AccessLevel] [-CacheName] [-Server] -AdminCredentials [-UserOrGroupName] [-UserOrGroupDN] [-DomainController] [-DomainControllerPort] [-SecondaryDomainController] [-SecondaryDomainControllerPort] [-DisableSecurity]
Examples of Remove-NCacheUserOrGroup
- This command removes the administrator user John Smith from the NCache server with the IP address 20.200.20.11. Upon successful removal of the user, NCache security is also disabled for the server.
Remove-NCacheUserOrGroup -Server 20.200.20.11 -AccessLevel Admin -AdminCredentials(Get-Credential john_smith) -UserOrGroupName john_smith -DisableSecurity Yes
- This command removes the user John Smith from the demoCache cache hosted on the server with the IP address 20.200.20.11.
Remove-NCacheUserOrGroup -CacheName demoCache -Server 20.200.20.11 -AccessLevel Cache -AdminCredentials(Get-Credential john_smith) -UserOrGroupName john_smith
- This command removes the group dev from the demoCache cache hosted on the server with the IP address 20.200.20.11. Upon successful removal of the group, NCache security is also disabled for the server.
Remove-NCacheUserOrGroup -CacheName demoCache -Server 20.200.20.11 -AccessLevel Cache -AdminCredentials(Get-Credential john_smith) -UserOrGroupName dev -DisableSecurity Yes
Properties
Note
The parameters with asterisk (*) on their names are the required parameters and the rest are optional.
| Parameters | Data Types | Description | Default Value |
|---|---|---|---|
-AccessLevel* |
<String> |
Specifies whether the user or group being removed is a cache user or an admin user. | - |
-CacheName* |
<String> |
Specifies the name of the cache for which the user or group is being added. This parameter is required when the access level is set to Cache. |
- |
-Server* |
<String> |
Specifies the name of the NCache server from which the user or group is being removed. | - |
-AdminCredentials* |
<pscredential> |
Specifies the credentials of an LDAP user with administrative rights on the given server. | - |
-UserOrGroupName* |
<String> |
Specifies the name of the user or group being added. | - |
-UserOrGroupDN* |
<String> |
Specifies the Distinguished Name (DN) of the user or group being added. This DN uniquely identifies the user or group in the LDAP directory. | - |
-DomainController* |
<String> |
Specifies the IP address or name of the server on which the domain controller is hosted. | - |
-DomainControllerPort |
<Integer> |
Specifies the port on which the domain controller is listening. | 389 |
-SecondaryDomainController |
<String> |
Specifies the IP address or name of the server on which the secondary domain controller is hosted. | - |
-SecondaryDomainControllerPort |
<Integer> |
Specifies the port on which the secondary domain controller is listening. | 389 |
-DisableSecurity |
<SwitchParameter> |
Specifies whether to disable security after successfully removing the user or group. Valid values are "Yes" or "No". | False |
