Partilhar via


Get-SCOMUserRole

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

Sintaxe

Empty (Predefinição)

Get-SCOMUserRole
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromUserRoleDisplayName

Get-SCOMUserRole
    [-DisplayName] <String[]>
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromUserRoleId

Get-SCOMUserRole
    -Id <Guid[]>
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromUserRoleName

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.
  • Âmbito de aplicação. 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"

Este 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 atual do grupo de gerenciamento.

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Credential

Especifica a conta de usuário sob a 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.

Propriedades dos parâmetros

Tipo:PSCredential
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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 trabalha. Os valores para esse parâmetro variam dependendo de quais pacotes de gerenciamento localizados são importados para o grupo de gerenciamento e da localidade do usuário que executa o Windows PowerShell.

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

FromUserRoleDisplayName
Position:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:

Guid[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

FromUserRoleId
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Name

Especifica uma matriz que contém os nomes dos 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.

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

FromUserRoleName
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:

Connection[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.