Get-SCOMUserRole
Obtém funções de usuário.
Syntax
Get-SCOMUserRole
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>] Get-SCOMUserRole
[-DisplayName] <String[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>] Get-SCOMUserRole
-Id <Guid[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>] Get-SCOMUserRole
-Name <String[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>] Description
O cmdlet Get-SCOMUserRole obtém funções de usuário. Uma função de usuário combina dois elementos:
- Perfil. Define a coleção de operações às quais a função de usuário tem acesso.
- Escopo. Define os limites para operações de perfil; por exemplo, tarefas e grupos.
Exemplos
Exemplo 1: Obter informações de função de usuário para uma função
PS C:\>Get-SCOMUserRole -Name "OperationsManagerReadOnlyOperators"Esse comando obtém as informações para a função de usuário chamada OperationsManagerReadOnlyOperators.
Parâmetros
-ComputerName
Especifica uma matriz de nomes de computadores. O cmdlet estabelece conexões temporárias com grupos de gerenciamento para esses computadores. Você pode usar nomes netbios, endereços IP ou FQDNs (nomes de domínio totalmente qualificados). Para especificar o computador local, digite o nome do computador, localhost ou um ponto (.).
O computador deve executar o serviço de Acesso a Dados do System Center.
Se você não especificar esse parâmetro, o padrão será o computador para a conexão do grupo de gerenciamento atual.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
Especifica a conta de usuário na qual a conexão do grupo de gerenciamento é executada.
Especifique um objeto PSCredential , como um que o cmdlet Get-Credential retorna, para esse parâmetro.
Para obter mais informações sobre objetos de credencial, digite Get-Help Get-Credential.
Se você especificar um computador no parâmetro ComputerName , use uma conta que tenha acesso a esse computador. O padrão é o usuário atual.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisplayName
Especifica uma matriz que contém os nomes de exibição de objetos de função de usuário. O cmdlet usa cada cadeia de caracteres na matriz e procura correspondências entre os nomes de exibição dos objetos de função de usuário com os quais esse cmdlet funciona. Os valores desse parâmetro variam dependendo de quais pacotes de gerenciamento localizados são importados para o grupo de gerenciamento e a localidade do usuário que executa Windows PowerShell.
| Type: | String[] |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Id
Especifica uma matriz de IDs para objetos de função de usuário. O cmdlet usa cada GUID (identificador global exclusivo) na matriz e procura correspondências com as propriedades de ID dos objetos de função de usuário que o cmdlet obtém.
| Type: | Guid[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Especifica uma matriz que contém os nomes de objetos de função de usuário. O cmdlet usa cada cadeia de caracteres na matriz e procura correspondências com as propriedades Name dos objetos de função de usuário que o cmdlet obtém.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SCSession
Especifica uma matriz de objetos Connection . Para obter objetos Connection , especifique o cmdlet Get-SCOMManagementGroupConnection .
Se você não especificar um valor para esse parâmetro, o cmdlet usará a conexão persistente ativa com um grupo de gerenciamento.
Use o parâmetro SCSession para especificar uma conexão persistente diferente.
Você pode criar uma conexão temporária com um grupo de gerenciamento usando os parâmetros ComputerName e Credential .
Para obter mais informações, digite Get-Help about_OpsMgr_Connections.
| Type: | Connection[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |