Get-AzureADUser
Obtém um usuário.
Sintaxe
GetQuery (Padrão)
Get-AzureADUser
[-All <Boolean>]
[-Top <Int32>]
[-Filter <String>]
[<CommonParameters>]
GetVague
Get-AzureADUser
[-SearchString <String>]
[-All <Boolean>]
[<CommonParameters>]
GetById
Get-AzureADUser
-ObjectId <String>
[-All <Boolean>]
[<CommonParameters>]
Description
O cmdlet Get-AzureADUser obtém um usuário da ID do Microsoft Entra.
Exemplos
Exemplo 1: Obter os dez principais usuários
PS C:\>Get-AzureADUser -Top 10
Este comando recebe 10 usuários.
Exemplo 2: Obter um usuário por ID
PS C:\>Get-AzureADUser -ObjectId "testUpn@tenant.com"
Esse comando obtém o usuário especificado.
Exemplo 3: Pesquisar entre usuários recuperados
PS C:\> Get-AzureADUser -SearchString "New"
ObjectId DisplayName UserPrincipalName UserType
-------- ----------- ----------------- --------
5e8b0f4d-2cd4-4e17-9467-b0f6a5c0c4d0 New user NewUser@contoso.onmicrosoft.com Member
2b450b8e-1db6-42cb-a545-1b05eb8a358b New user NewTestUser@contoso.onmicrosoft.com Member
Esse cmdlet obtém todos os usuários que correspondem ao valor de SearchString em relação aos primeiros caracteres em DisplayName ou UserPrincipalName.
Exemplo 4: Obter um usuário por userPrincipalName
PS C:\>Get-AzureADUser -Filter "userPrincipalName eq 'jondoe@contoso.com'"
Esse comando obtém o usuário especificado.
Exemplo 5: Obter um usuário por JobTitle
PS C:\>Get-AzureADUser -Filter "startswith(JobTitle,'Sales')"
Este comando obtém todos os usuários cujo cargo começa com vendas, por exemplo, Gerente de Vendas e Assistente de Vendas.
Parâmetros
-All
Se true, retorne todos os usuários. Se for falso, retorne o número de objetos especificados pelo parâmetro Top
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Filter
Especifica uma instrução de filtro OData v3.0. Esse parâmetro controla quais objetos são retornados. Detalhes sobre consultas com OData podem ser encontrados aqui. http://www.odata.org/documentation/odata-version-3-0/odata-version-3-0-core-protocol/#queryingcollections. Nem todas as funções e operadores do OData v3.0 têm suporte no momento.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
GetQuery
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-ObjectId
Especifica a ID (como um UPN ou ObjectId) de um usuário na ID do Microsoft Entra.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
GetById
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-SearchString
Especifica uma cadeia de caracteres de pesquisa.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
GetVague
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Top
Especifica o número máximo de registros a serem retornados.
Propriedades do parâmetro
| Tipo: | Int32 |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
GetQuery
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | 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.
Observações
Consulte o guia de migração de Get-AzureADUser para o PowerShell do Microsoft Graph.