Removes an authorized user from the ESI Service.
Syntax
Remove-EmcUser [-Name] <String> [[-Role] <String>] [-ServiceUrl <String>] [-Silent] [<CommonParameters>]
Description
This command removes a Windows user or security group that has been granted one or more roles in the ESI Service. It can remove a single role for the user or remove all roles.
Parameters
-Name <String>
Attributes: Required, Position: 1
The name of the user to remove.
-Role <String>
Attributes: Optional, Position: 2
If specified, removes only the specified role from the user. If omitted, the parameter removes all roles from the user.
-ServiceUrl <String>
Attributes: Optional, Position: named
Specifies the base URL for the ESI Service. This must contain only the scheme, host, and port. If no value is specified, ESI uses the default of localhost or the value set by using the Set-EmcServiceUrl cmdlet.
-Silent <SwitchParameter>
Attributes: Optional, Position: named
Turns off all the informational and verbose messages. However, it still displays errors.
<CommonParameters>
This cmdlet supports these common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, and OutVariable. Type get-help about_commonparameters for more details.
Examples
-------------- Example 1 --------------
C:\PS>Remove-EmcUser "SR5DOM\ESI SCOM Agents" Administrator
SR5DOM\ESI SCOM Agents removed from Administrator role
This example removes a role from a user.
-------------- Example 2 --------------
C:\PS>Remove-EmcUser SR5DOM\songd2
SR5DOM\songd2 removed from all roles
This example removes all roles from a user.