Ver contas de utilizador do Microsoft 365 com o PowerShell
Este artigo aplica-se tanto a Microsoft 365 Enterprise como a Office 365 Enterprise.
Pode utilizar o centro de administração do Microsoft 365 para ver as contas do seu inquilino do Microsoft 365. O PowerShell para Microsoft 365 ativa esta funcionalidade, mas também fornece funcionalidades adicionais.
Ver contas de utilizador com o Microsoft Graph PowerShell
Nota
O módulo do PowerShell do Azure Active Directory (AzureAD) está a ser preterido e substituído pelo SDK do PowerShell do Microsoft Graph. Pode utilizar o SDK do PowerShell do Microsoft Graph para aceder a todas as APIs do Microsoft Graph. Para obter mais informações, veja Introdução ao SDK do PowerShell do Microsoft Graph.
Veja também Instalar o SDK do PowerShell do Microsoft Graph e Atualizar do Azure AD PowerShell para o Microsoft Graph PowerShell para obter informações sobre como instalar e atualizar para o Microsoft Graph PowerShell, respetivamente.
Primeiro, instale o software necessário para utilizar o Microsoft Graph PowerShell. Consulte Ligar ao Microsoft 365 com o Microsoft Graph PowerShell para obter mais informações.
Em seguida, execute o seguinte cmdlet para ligar à sua organização com o âmbito de permissão necessário, que neste caso é User.ReadBasic.All:
# Connect to Microsoft Graph
Connect-Graph -Scopes User.ReadBasic.All
Ver todas as contas
Para apresentar a lista completa de contas de utilizador com o ID de utilizador e o nome principal de utilizador, execute este comando:
Get-MgUser -All | Select DisplayName,Id,UserPrincipalName
Deverá obter informações semelhantes a esta:
DisplayName Id UserPrincipalName
----------- -- -----------------
Conf Room Adams 6e206948-b2b6-406c-a728-80bbe78e4003 Adams@M365x89521157.OnMicrosoft.com
Adele Vance 916a6a08-b9d0-44b6-870f-562d8358a314 AdeleV@M365x89521157.OnMicrosoft.com
MOD Administrator 5710f237-df3f-4bcd-b875-82deb02f98aa admin@M365x89521157.onmicrosoft.com
Alex Wilber 8aa561dc-441d-4d74-aeb3-e2be41c116c8 AlexW@M365x89521157.OnMicrosoft.com
Allan Deyoung 6b629e5e-3cf4-42d0-8007-3a93f0253382 AllanD@M365x89521157.OnMicrosoft.com
Automate Bot 3a70feb4-9407-47b5-9b61-7526ac0e98d8 AutomateB@M365x89521157.OnMicrosoft.com
Conf Room Baker d8cf3fef-1d03-4b9c-9be0-fed44fb87596 Baker@M365x89521157.OnMicrosoft.com
Bianca Pisani 7fe8c2d1-eb8e-4032-96ba-26242ff0acd9 BiancaP@M365x89521157.OnMicrosoft.com
Ver uma conta específica
Para apresentar uma conta de utilizador específica, execute o seguinte comando. Preencha o nome da conta de início de sessão da conta de utilizador, que também é conhecida como o nome principal de utilizador (UPN). Remova os carateres "<" e ">".
Get-MgUser -UserId '<user principal name>'
Eis um exemplo:
Get-MgUser -UserId 'BelindaN@litwareinc.onmicosoft.com'
Ver valores de propriedade adicionais para uma conta específica
Por predefinição, o cmdlet Get-MgUser apresenta apenas as propriedades DisplayName, Id, Mail e UserPrincipalName das contas.
Para ser mais seletivo sobre as propriedades a apresentar, utilize o cmdlet Select em combinação com o cmdlet Get-MgUser . Para combinar os dois cmdlets, utilize o caráter "pipe" ("|"), que indica ao PowerShell para obter os resultados de um comando e enviá-lo para o comando seguinte. Eis um comando de exemplo que apresenta DisplayName, Department e UsageLocation para cada conta de utilizador:
Get-MgUser -All | Select DisplayName,Department,UsageLocation
Este comando indica ao PowerShell para:
Obtenha todas as informações sobre as contas de utilizador (Get-MgUser) e envie-as para o comando seguinte (|).
Apresentar apenas o nome da conta de utilizador, o departamento e a localização de utilização (Selecione DisplayName, Department, UsageLocation).
Para ver todas as propriedades de uma conta de utilizador específica, utilize o cmdlet Select e o caráter universal (*). Eis um exemplo:
Get-MgUser -UserID 'BelindaN@litwareinc.onmicosoft.com' | Select *
Como outro exemplo, execute o seguinte comando para verificar o estado ativado de uma conta de utilizador específica:
Get-MgUser -UserID '<sign-in name of the user account>' | Select DisplayName,UserPrincipalName,AccountEnabled
Ver estado de sincronização da conta
As contas de utilizador têm duas origens:
Windows Server Active Directory (AD), que são contas que são sincronizadas do AD no local para a cloud.
Microsoft Entra contas, que são criadas diretamente na cloud.
Pode utilizar o seguinte comando para localizar contas que estão a sincronizar a partir do AD no local . Indica ao PowerShell para obter todos os utilizadores com o atributo OnPremisesSyncEnabled definido como Verdadeiro.
Get-MgUser -All -Filter 'OnPremisesSyncEnabled eq true'
Pode utilizar o seguinte comando para localizar contas apenas na cloud . Instrui o PowerShell a obter todos os utilizadores com o atributo OnPremisesSyncEnabled definido como Falso ou não definido (Nulo). Uma conta que nunca foi sincronizada a partir do AD no local tem OnPremisesSyncEnabled definida como Null. Uma conta que foi sincronizada inicialmente a partir do AD no local, mas que já não está a ser sincronizada, tem OnPremisesSyncEnabled definido como Falso.
Get-MgUser -All | Where OnPremisesSyncEnabled -ne true
OnPremisesSyncEnabled
Ver contas com base numa propriedade comum
Para ser mais seletivo sobre a lista de contas a apresentar, pode utilizar o cmdlet Where em combinação com o cmdlet Get-MgUser . Para combinar os dois cmdlets, utilize o caráter "pipe" ("|"), que indica ao PowerShell para obter os resultados de um comando e enviá-lo para o comando seguinte. Eis um comando de exemplo que apresenta apenas as contas de utilizador que têm uma localização de utilização não especificada:
Get-MgUser | Where UsageLocation -eq $Null
Este comando indica ao PowerShell para:
Obtenha todas as informações sobre as contas de utilizador (Get-MgUser) e envie-as para o comando seguinte (|).
Localize todas as contas de utilizador que têm uma localização de utilização não especificada (Where UsageLocation -eq $Null). O comando indica ao PowerShell para localizar apenas o conjunto de contas para as quais a propriedade usageLocation user account (UsageLocation) não está especificada (-eq $Null).
A propriedade UsageLocation é apenas uma das muitas propriedades associadas a uma conta de utilizador. Para apresentar todas as propriedades de uma conta de utilizador específica, utilize o cmdlet Select e o caráter universal (*). Eis um exemplo:
Get-MgUser -UserID BelindaN@litwareinc.onmicosoft.com | Select *
Por exemplo, Cidade é o nome de uma propriedade de conta de utilizador. Pode utilizar o seguinte comando para listar todas as contas de utilizadores que vivem em Londres:
Get-MgUser | Where City -eq "London"
Sugestão
A sintaxe do cmdlet Where nestes exemplos é Where [nome da propriedade da conta de utilizador] [operador de comparação] [valor ].> [operador de comparação] é -eq para iguais, -ne para não é igual a, -lt para menor que, -gt para maior do que, entre outros. [valor] é normalmente uma cadeia (uma sequência de letras, números e outros carateres), um valor numérico ou $Null para não especificado. Para obter mais informações, consulte Onde.
Consulte também
Gerir contas de utilizador, licenças e grupos do Microsoft 365 com o PowerShell