Get-MsolUser
Obtém usuários do Azure Active Directory.
Sintaxe
Get-MsolUser
[-ReturnDeletedUsers]
[-City <String>]
[-Country <String>]
[-Department <String>]
[-DomainName <String>]
[-EnabledFilter <UserEnabledFilter>]
[-State <String>]
[-Synchronized]
[-Title <String>]
[-HasErrorsOnly]
[-LicenseReconciliationNeededOnly]
[-UnlicensedUsersOnly]
[-UsageLocation <String>]
[-SearchString <String>]
[-MaxResults <Int32>]
[-TenantId <Guid>]
[<CommonParameters>] Get-MsolUser
-ObjectId <Guid>
[-ReturnDeletedUsers]
[-TenantId <Guid>]
[<CommonParameters>] Get-MsolUser
[-ReturnDeletedUsers]
-UserPrincipalName <String>
[-TenantId <Guid>]
[<CommonParameters>] Get-MsolUser
[-ReturnDeletedUsers]
[-City <String>]
[-Country <String>]
[-Department <String>]
[-DomainName <String>]
[-EnabledFilter <UserEnabledFilter>]
[-State <String>]
[-Synchronized]
[-Title <String>]
[-HasErrorsOnly]
[-LicenseReconciliationNeededOnly]
[-UnlicensedUsersOnly]
[-UsageLocation <String>]
[-SearchString <String>]
[-All]
[-TenantId <Guid>]
[<CommonParameters>] Description
O cmdlet Get-MsolUser obtém um usuário individual ou uma lista de usuários. Especifique o parâmetro ObjectId ou UserPrincipalName para obter um usuário específico.
Exemplos
Exemplo 1: Obter todos os usuários
PS C:\> Get-MsolUserEsse comando recupera todos os usuários da empresa. Ele exibe até o valor padrão de 500 resultados.
Exemplo 2: Obter usuários habilitados
PS C:\> Get-MsolUser -EnabledFilter EnabledOnly -MaxResults 2000Esse comando obtém até 2.000 usuários habilitados.
Exemplo 3: Obter um usuário por UPN
PS C:\> Get-MsolUser -UserPrincipalName "davidchew@contoso.com"Esse comando recupera o usuário com o UPN davidchew@contoso.com.
Exemplo 4: Obter um usuário por ID de objeto
PS C:\> Get-MsolUser -ObjectId 81701046-cb37-439b-90ce-2afd9630af7dEsse comando recupera um usuário que tem a ID de objeto especificada.
Exemplo 5: Obter usuários por cadeia de caracteres de pesquisa
PS C:\> Get-MsolUser -SearchString "David"Esse comando recupera uma lista de usuários com David no nome de exibição ou endereço de email.
Exemplo 6: Obter o local de dados preferencial de um usuário
PS C:\> Get-MsolUser -UserPrincipalName "davidchew@contoso.onmicrosoft.com" | Select PreferredDataLocationEsse comando retorna o local de dados preferencial de um usuário.
Parâmetros
-All
Indica que este cmdlet retorna todos os resultados. Não especifique junto com o parâmetro MaxResults .
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-City
Especifica a cidade na qual filtrar os resultados.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Country
Especifica o país ou a região no qual filtrar os resultados.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Department
Especifica o departamento no qual filtrar os resultados.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DomainName
Especifica o domínio no qual filtrar os resultados. Esse deve ser um domínio verificado para a empresa. Todos os usuários com um endereço de email, primário ou secundário, nesse domínio são retornados.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-EnabledFilter
Especifica o filtro para usuários habilitados ou desabilitados. Os valores válidos são All, EnabledOnly e DisabledOnly.
| Tipo: | UserEnabledFilter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-HasErrorsOnly
Inida que esse cmdlet retorna apenas usuários que têm erros de validação.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-LicenseReconciliationNeededOnly
Indica que esse filtro de cmdlet só é usado para usuários que exigem reconciliação de licença.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-MaxResults
Especifica o número máximo de resultados que esse cmdlet retorna. O valor padrão é 500.
| Tipo: | Int32 |
| Cargo: | Named |
| Valor padrão: | 500 |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ObjectId
Especifica a ID de objeto exclusiva do usuário a ser obtido.
| Tipo: | Guid |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-ReturnDeletedUsers
Indica que esse cmdlet retorna apenas usuários na lixeira.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-SearchString
Especifica uma cadeia de caracteres para corresponder ao endereço de email ou ao nome de exibição começando com essa cadeia de caracteres.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-State
Especifica o filtro para o estado do usuário.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Synchronized
Indica que esse cmdlet retorna apenas usuários sincronizados por meio da Sincronização do Azure Active Directory.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-TenantId
Especifica a ID exclusiva do locatário no qual executar a operação. O valor padrão é o locatário do usuário atual. Esse parâmetro se aplica somente a usuários parceiros.
| Tipo: | Guid |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-Title
Speicifis o filtro para o título do usuário.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-UnlicensedUsersOnly
Indica que esse cmdlet retorna apenas usuários que não recebem uma licença.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-UsageLocation
Especifica o filtro para o país ou região em que os serviços são consumidos pelo usuário. Especifique um código de país ou região de duas letras.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-UserPrincipalName
Speicifis a ID de usuário do usuário a recuperar.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
Saídas
Microsoft.Online.Administration.User
Esse cmdlet retorna objetos de usuário, que incluem as seguintes informações:
AlternateEmailAddresses. Endereço de email alternativo do usuário (externo ao Azure Active Directory).
BlockCredential. se o usuário é ou não capaz de fazer logon.
Cidade. a cidade do usuário.
País. O país ou a região do usuário.
Departamento. o departamento do usuário.
DisplayName. O nome de exibição do usuário.
Erros. uma matriz de erros. Esses são erros de validação que podem resultar em perda de serviços.
Fax. o número de fax do usuário.
Firstname. O nome do usuário.
ImmutableID. somente retornado para os usuários federados. Essa é a ID necessária para ser federada com o Azure Active Directory.
isBlackBerryUser. retorna se o usuário tem ou não um dispositivo BlackBerry.
isLicensed. se o usuário tem ou não alguma licença atribuída.
LastDirSyncTime. A data e a hora da última sincronização de diretório (retornada somente de usuários sincronizados com o Azure Active Directory por meio da sincronização do Active Directory).
LastPasswordChangeTimestamp. A hora mais recente em que uma alteração de senha para o usuário foi registrada no Azure Active Directory.
LastName. O sobrenome do usuário.
LicenseReconciliationNeeded. se o usuário atualmente tem ou não uma caixa de correio sem uma licença. Neste caso, o usuário deve estar licenciado durante 30 dias para evitar perder sua caixa de correio.
Licenças. uma lista de licenças do usuário.
Liveid. o ID de logon exclusivo do usuário.
Celular. o número de celular do usuário.
Objectid. o ID exclusivo do usuário.
Escritório. o número do escritório do usuário.
OverallProvisioningStatus. se o usuário foi ou não provisionado para seus serviços.
PasswordNeverExpires. se a senha do usuário deve ou não ser forçada a ser alterada a cada 90 dias.
Phonenumber. o número de telefone do usuário.
Postalcode. o CEP do usuário.
PreferredDataLocation. O local de dados preferencial do usuário.
PreferredLanguage. o idioma preferido do usuário.
Proxyaddresses. Os endereços proxy associados a esse usuário.
Estado. o estado do usuário.
Streetaddress. o endereço do usuário.
StrongPasswordRequired. se o usuário deve ou não definir uma senha forte quando altera sua senha. As senhas fortes são recomendadas.
Título. o título do usuário.
UsageLocation. O país ou região em que os serviços são consumidos pelo usuário. Deve ser um código de país ou região de duas letras.
Userprincipalname. o ID do usuário.
ValidationStatus. se o usuário tem ou não algum erro.