Gets the authorized users of the ESI Service.
Syntax
Get-EmcUser [[-Pattern] <String>] [-Role <String>] [-ServiceUrl <String>] [-Silent] [<CommonParameters>]
Description
This command returns the list of Windows users or security groups that have an authorized role in the ESI Service.
Parameters
-Pattern <String>
Attributes: Optional, Position: 1
If specified, filters the resulting list of users with names matching the Regex pattern.
-Role <String>
Attributes: Optional, Position: named
If specified, only returns users who have the specified role of Administrator or Monitor.
-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>Get-EmcUser
Name SID Roles
---- --- -----
SR5DOM\songd2 S-1-5-21-1311685843-2211060-2... {Administrator}
SR5DOM\ESI SCOM Agents S-1-5-21-1311685843-2211060-2... {Monitor}
This example gets all authorized users.
-------------- Example 2 --------------
C:\PS>Get-EmcUser -Role Monitor
Name SID Roles
---- --- -----
SR5DOM\ESI SCOM Agents S-1-5-21-1311685843-2211060-2... {Monitor}
This example gets all authorized users with the Monitor role.
-------------- Example 3 --------------
C:\PS>Get-EmcUser *scom*
Name SID Roles
---- --- -----
SR5DOM\ESI SCOM Agents S-1-5-21-1311685843-2211060-2... {Monitor}
This example gets the users with a name that matches a wildcard pattern.