Share via

Get-CMAdministrativeUser

  • Referência
Módulo:
ConfigurationManager

Obtenha um usuário administrativo.

Syntax

Get-CMAdministrativeUser
   [-Name <String>]
   [-RoleName <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMAdministrativeUser
   -Id <String>
   [-RoleName <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Use este cmdlet para obter um ou mais usuários administrativos em Configuration Manager. Um usuário administrativo tem um conjunto definido de permissões e pode ser membro de um ou mais escopos ou funções. Um usuário administrativo no Configuration Manager define um usuário ou grupo local ou de domínio. Para obter mais informações sobre funções de segurança, consulte Fundamentos da administração baseada em função em Configuration Manager.

Observação

Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, confira introdução.

Exemplos

Exemplo 1: obter todos os usuários administrativos

Esse comando obtém todos os usuários administrativos. Ele exibe a saída como uma tabela mostrando o nome da conta (LogonName), funções de segurança (RoleNames), escopos de segurança (CategoryNames) e coleções (CollectionNames).

Get-CMAdministrativeUser | Select-Object LogonName, RoleNames, CategoryNames, CollectionNames

Exemplo 2: obter um usuário administrativo pelo nome

Esse comando obtém o usuário administrativo chamado jqpublic.

Get-CMAdministrativeUser -Name "Contoso\jqpublic"

Exemplo 3: obter todos os usuários com escopo específico

Esse comando obtém todos os usuários administrativos com o escopo Padrão e exibe os nomes da conta.

Get-CMAdministrativeUser | Where-Object { $_.CategoryNames -contains "Default" } | Select-Object LogonName

Exemplo 4: obter todos os usuários com função específica

Esse comando obtém todos os usuários administrativos com a função Administrador Completo e exibe os nomes da conta.

Get-CMAdministrativeUser -RoleName "Full Administrator" | Select-Object LogonName

Parâmetros

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Especifique a ID do usuário administrativo a ser obtido. Esse valor é a AdminID propriedade. É um valor inteiro, por exemplo 16777234.

Type:String
Aliases:AdminId
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifique o nome do usuário administrativo a ser obtido. Por exemplo, domain\username ou domain\groupname

Você pode usar caracteres curinga:

  • *: vários caracteres
  • ?: caractere único
Type:String
Aliases:DisplayName, LogonName, UserName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-RoleName

Especifique uma matriz de nomes de função de segurança. Esse nome pode ser para uma função interna ou personalizada. Para ver a lista de funções de segurança internas, confira funções de segurança.

Type:String[]
Aliases:RoleNames
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

None

Saídas

IResultObject[]

IResultObject

Observações

Para obter mais informações sobre esse objeto retornado e suas propriedades, consulte SMS_Admin classe WMI do servidor.