Compartilhar via

Get-SCOMUserRole

  • Referência
Módulo:
OperationsManager

Obtém funções de usuário.

Sintaxe

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 à qual a função de usuário tem acesso.
  • Âmbito. 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 da função de usuário denominada 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.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:PSCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 o Windows PowerShell.

Tipo:String[]
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 a ID propriedades dos objetos de função de usuário que o cmdlet obtém.

Tipo:Guid[]
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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.

Tipo:Connection[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False