Get-MsolUser
Obtém utilizadores do Azure Active Directory.
Syntax
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 utilizador individual ou uma lista de utilizadores. Especifique o parâmetro ObjectId ou UserPrincipalName para obter um utilizador específico.
Exemplos
Exemplo 1: Obter todos os utilizadores
PS C:\> Get-MsolUserEste comando obtém todos os utilizadores na empresa. Apresenta até ao valor predefinido de 500 resultados.
Exemplo 2: Obter utilizadores ativados
PS C:\> Get-MsolUser -EnabledFilter EnabledOnly -MaxResults 2000Este comando recebe até 2000 utilizadores ativados.
Exemplo 3: Obter um utilizador por UPN
PS C:\> Get-MsolUser -UserPrincipalName "davidchew@contoso.com"Este comando obtém o utilizador com o UPN davidchew@contoso.com.
Exemplo 4: Obter um utilizador por ID de objeto
PS C:\> Get-MsolUser -ObjectId 81701046-cb37-439b-90ce-2afd9630af7dEste comando obtém um utilizador que tem o ID de objeto especificado.
Exemplo 5: Obter utilizadores por cadeia de pesquisa
PS C:\> Get-MsolUser -SearchString "David"Este comando obtém uma lista de utilizadores com o David no nome a apresentar ou endereço de e-mail.
Exemplo 6: obter a localização de dados preferencial de um utilizador
PS C:\> Get-MsolUser -UserPrincipalName "davidchew@contoso.onmicrosoft.com" | Select PreferredDataLocationEste comando devolve a localização de dados preferencial de um utilizador.
Parâmetros
-All
Indica que este cmdlet devolve todos os resultados. Não especifique em conjunto com o parâmetro MaxResults .
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-City
Especifica a cidade para filtrar os resultados.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Country
Especifica o país ou região para filtrar os resultados.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Department
Especifica o departamento para filtrar os resultados.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DomainName
Especifica o domínio no qual filtrar os resultados. Tem de ser um domínio verificado para a empresa. Todos os utilizadores com um endereço de e-mail, principal ou secundário, neste domínio são devolvidos.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnabledFilter
Especifica o filtro para utilizadores ativados ou desativados. Os valores válidos são Todos, EnabledOnly e DisabledOnly.
| Type: | UserEnabledFilter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-HasErrorsOnly
Inidata que este cmdlet devolve apenas utilizadores com erros de validação.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LicenseReconciliationNeededOnly
Indica que este filtro de cmdlet apenas para utilizadores que necessitam de reconciliação de licenças.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaxResults
Especifica o número máximo de resultados devolvidos por este cmdlet. O valor predefinido é 500.
| Type: | Int32 |
| Position: | Named |
| Default value: | 500 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ObjectId
Especifica o ID de objeto exclusivo do utilizador a obter.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ReturnDeletedUsers
Indica que este cmdlet devolve apenas utilizadores na reciclagem.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SearchString
Especifica uma cadeia para corresponder ao endereço de e-mail ou ao nome a apresentar a partir desta cadeia.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-State
Especifica o filtro para o estado do utilizador.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Synchronized
Indica que este cmdlet devolve apenas os utilizadores sincronizados através do Azure Active Directory Sync.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TenantId
Especifica o ID exclusivo do inquilino no qual efetuar a operação. O valor predefinido é o inquilino do utilizador atual. Este parâmetro aplica-se apenas aos utilizadores parceiros.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Title
Desestreia o filtro para o título do utilizador.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UnlicensedUsersOnly
Indica que este cmdlet devolve apenas os utilizadores a quem não foi atribuída uma licença.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UsageLocation
Especifica o filtro para o país ou região onde os serviços são consumidos pelo utilizador. Especifique um país de duas letras ou um código de região.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserPrincipalName
A Desempolíticafia o ID de utilizador do utilizador a obter.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Saídas
Microsoft.Online.Administration.User
Este cmdlet devolve objetos de utilizador, que incluem as seguintes informações:
AlternateEmailAddresses. Endereço de e-mail alternativo do utilizador (externo ao Azure Active Directory).
BlockCredential. Se o utilizador consegue ou não iniciar sessão.
A cidade. A cidade do utilizador.
O país. O país ou região do utilizador.
Departamento. O departamento do utilizador.
DisplayName. O nome a apresentar do utilizador.
Erros. Uma matriz de erros. Estes são erros de validação que podem resultar na perda de serviços.
Fax. O número de fax do utilizador.
NomePróprio. O nome próprio do utilizador.
ImutávelID. Apenas devolvido para utilizadores federados. Este é o ID necessário para ser federado com o Azure Active Directory.
isBlackBerryUser. Devolve se o utilizador tem ou não um dispositivo BlackBerry.
isLicensed. Se o utilizador tem ou não licenças atribuídas.
LastDirSyncTime. A data e hora da última sincronização de diretórios (apenas devolvida pelos utilizadores sincronizados com o Azure Active Directory através da sincronização do Active Directory).
LastPasswordChangeTimestamp. A hora mais recente em que uma alteração de palavra-passe para o utilizador foi registada no Azure Active Directory.
Apelido. O apelido do utilizador.
LicenseReconciliationNeeded. Se o utilizador tem ou não uma caixa de correio sem uma licença. Neste caso, o utilizador deve ter uma licença de 30 dias para evitar perder a caixa de correio.
Licenças. Uma lista das licenças do utilizador.
LiveID. O ID de início de sessão exclusivo do utilizador.
MobilePhone. O número de telemóvel do utilizador.
ObjectId. O ID exclusivo do utilizador.
O Office. O número de escritório do utilizador.
OverallProvisioningStatus. Se o utilizador foi ou não aprovisionado para os seus serviços.
PasswordNeverExpires. Se a palavra-passe do utilizador deve ser forçada a ser alterada a cada 90 dias.
PhoneNumber. O número de telefone do utilizador.
Código Postal. O código postal do utilizador.
PreferredDataLocation. A localização de dados preferencial do utilizador.
PreferredLanguage. O idioma preferencial do utilizador.
ProxyAddresses. Os endereços proxy associados a este utilizador.
Estado. O estado do utilizador.
StreetAddress. A morada do utilizador.
StrongPasswordRequired. Se o utilizador é obrigado a definir uma palavra-passe segura quando altera a palavra-passe. São recomendadas palavras-passe fortes.
Título. O título do utilizador.
UsageLocation. O país ou região onde os serviços são consumidos pelo utilizador. Tem de ser um indicativo de país ou região de duas letras.
UserPrincipalName. O ID de utilizador do utilizador.
ValidationStatus. Se o utilizador tem ou não erros.
Ligações Relacionadas
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários