Get-AzureADUser
Obtém um usuário.
Sintaxe
GetQuery (Predefiniçã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 melhores utilizadores
PS C:\>Get-AzureADUser -Top 10
Este comando obtém 10 usuários.
Exemplo 2: Obter um utilizador por ID
PS C:\>Get-AzureADUser -ObjectId "testUpn@tenant.com"
Este comando obtém o usuário especificado.
Exemplo 3: Pesquisa entre utilizadores 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
Este 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'"
Este 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 verdadeiro, retorne todos os usuários. Se false, retorne o número de objetos especificado pelo parâmetro Top
Propriedades dos parâmetros
| Tipo: | Boolean |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-Filter
Especifica uma instrução de filtro OData v3.0. Este 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 OData v3.0 são suportados no momento.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
GetQuery
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-ObjectId
Especifica a ID (como um UPN ou ObjectId) de um usuário no Microsoft Entra ID.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
GetById
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-SearchString
Especifica uma cadeia de caracteres de pesquisa.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
GetVague
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-Top
Especifica o número máximo de registros a serem retornados.
Propriedades dos parâmetros
| Tipo: | Int32 |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
GetQuery
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| 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.
Notas
Consulte o guia de migração de Get-AzureADUser para o Microsoft Graph PowerShell.