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 [-Server]  -AccessLevel  \
                          [-CacheName] -UserOrGroupName \
                          [-UserOrGroupDN] [-DomainController] \
                          [-DomainControllerPort] [-SecondaryDomainController] \
                          [-SecondaryDomainControllerPort ] -NodeAdminCredentials \
                          [<CommonParameters>]

Examples

• This command removes the administrator user David Watson 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 using credentials.

$nodeAdmin = Get-Credential \
Remove-NCacheUserOrGroup -Server 20.200.20.11 \
-AccessLevel Admin -NodeAdminCredentials $nodeAdmin \
-UserOrGroupName david_watson

• This command removes the user David Watson from the demoCache cache hosted on the server with the IP address 20.200.20.11.

$nodeAdmin = Get-Credential \
Remove-NCacheUserOrGroup -Server 20.200.20.11 \
-AccessLevel Cache -CacheName demoCache \
-NodeAdminCredentials $nodeAdmin -UserOrGroupName david_watson

• This command removes the gMSA cache user user1gmsa$ from the cache named demoCache on server 20.200.20.11. The credentials supplied through -NodeAdminCredentials are used to authorize the remove operation.

$nodeAdmin = Get-Credential
Remove-NCacheUserOrGroup -Server 20.200.20.11 \
                         -AccessLevel Cache -CacheName demoCache \
                         -NodeAdminCredentials $nodeAdmin \
                         -UserOrGroupName user1gmsa$

• 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.

$nodeAdmin = Get-Credential 
Remove-NCacheUserOrGroup -Server 20.200.20.11 \
-AccessLevel Cache -CacheName demoCache \
-NodeAdminCredentials $nodeAdmin -UserOrGroupName dev

Properties

Note

The parameters with asterisk (*) on their names are the required parameters and the rest are optional.

Parameters	Data Types	Description
-Server*	<string>	Specifies the IP address of the NCache server from which the user or group is being removed.
-UserOrGroupName*	<string>	Specifies the name of the user or group being removed.
-DomainControllerPort	<int>	Specifies the port on which the domain controller is listening. The default port is 389.
-DomainController	<string>	Specifies the IP address or hostname of the domain controller used to validate the user or group identity.
-SecondaryDomainControllerPort	<int>	Specifies the port on which the secondary domain controller is listening. The default port is 389.
-SecondaryDomainController	<string>	Specifies the IP address or hostname of the secondary domain controller used to validate the user or group identity.
-AccessLevel*	<string>	Specifies whether the user or group being removed is an NCache administrator or a cache-specific user.
-CacheName	<string>	Specifies the name of the cache for which the user or group is being removed. This parameter is required when -AccessLevel is set to Cache.
-NodeAdminCredentials*	<pscredential>	Specifies the credentials of a user with sufficient privileges to remove a user or group from NCache.