Remove-EmcUser (ESI Service)

Removes an authorized user from the ESI Service.



Remove-EmcUser [-Name] <String> [[-Role] <String>] [-ServiceUrl <String>] [-Silent] [<CommonParameters>]



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.



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



This cmdlet supports these common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, and OutVariable. Type get-help about_commonparameters for more details.



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