Get-CMAdministrativeUser
Obter um utilizador administrativo.
Sintaxe
Get-CMAdministrativeUser
[-Name <String>]
[-RoleName <String[]>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
Get-CMAdministrativeUser
-Id <String>
[-RoleName <String[]>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
Description
Utilize este cmdlet para obter um ou mais utilizadores administrativos no Configuration Manager. Um utilizador administrativo tem um conjunto definido de permissões e pode ser membro de um ou mais âmbitos ou funções. Um utilizador administrativo no Configuration Manager define um utilizador ou grupo local ou de domínio. Para obter mais informações sobre funções de segurança, veja Noções básicas da administração baseada em funções no Configuration Manager.
Observação
Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>
. Para obter mais informações, veja Introdução.
Exemplos
Exemplo 1: Obter todos os utilizadores administrativos
Este comando obtém todos os utilizadores administrativos. Apresenta o resultado como uma tabela que mostra o nome da conta (LogonName), as funções de segurança (RoleNames), os âmbitos de segurança (CategoryNames) e as coleções (CollectionNames).
Get-CMAdministrativeUser | Select-Object LogonName, RoleNames, CategoryNames, CollectionNames
Exemplo 2: Obter um utilizador administrativo pelo nome
Este comando obtém o utilizador administrativo com o nome jqpublic.
Get-CMAdministrativeUser -Name "Contoso\jqpublic"
Exemplo 3: Obter todos os utilizadores com âmbito específico
Este comando obtém todos os utilizadores administrativos com o âmbito Predefinido e apresenta os nomes das contas.
Get-CMAdministrativeUser | Where-Object { $_.CategoryNames -contains "Default" } | Select-Object LogonName
Exemplo 4: Obter todos os utilizadores com uma função específica
Este comando obtém todos os utilizadores administrativos com a função Administrador Completo e apresenta os nomes das contas.
Get-CMAdministrativeUser -RoleName "Full Administrator" | Select-Object LogonName
Parâmetros
-DisableWildcardHandling
Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ForceWildcardHandling
Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Id
Especifique o ID do utilizador administrativo a obter. Este valor é a AdminID
propriedade . É um valor inteiro, por exemplo 16777234
.
Tipo: | String |
Aliases: | AdminId |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Name
Especifique o nome do utilizador administrativo a obter. Por exemplo, domain\username
ou domain\groupname
Pode utilizar carateres universais:
-
*
: Múltiplos carateres -
?
: caráter único
Tipo: | String |
Aliases: | DisplayName, LogonName, UserName |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | True |
-RoleName
Especifique uma matriz de nomes de funções de segurança. Este nome pode ser para uma função incorporada ou personalizada. Para ver a lista de funções de segurança incorporadas, veja Funções de segurança.
Tipo: | String[] |
Aliases: | RoleNames |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Entradas
None
Saídas
IResultObject[]
IResultObject
Observações
Para obter mais informações sobre este objeto de retorno e as respetivas propriedades, veja SMS_Admin classe WMI de servidor.