Add-EmcUser (ESI Service)

Adds an authorized user to the ESI Service.



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



The ESI Service can only be accessed by authorized users. This command adds a Windows user or security group with the specified role to the ESI Service.



-Name <String>

Attributes: Required, Position: 1

Specifies the name of the user to add. This is a Windows user or security group in <Domain>\<UserName> format. This must be a valid Windows user or security group, or the user will not be added.


-Role <String>

Attributes: Required, Position: 2

Specifies the role of Administrator or Monitor to assign to 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>Add-EmcUser "SR5DOM\ESI SCOM Agents" Monitor


Name                              SID                              Roles

----                              ---                              -----

SR5DOM\ESI SCOM Agents            S-1-5-21-1311685843-2211060-2... {Monitor}

This example adds a security group for the Monitor role.