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

1. 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.

2. 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:

1. Obtenha todas as informações sobre as contas de utilizador (Get-MgUser) e envie-as para o comando seguinte (|).

2. 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```

### View accounts based on a common property

To be more selective about the list of accounts to display, you can use the **Where** cmdlet in combination with the **Get-MgUser** cmdlet. To combine the two cmdlets, use the "pipe" character ("|"), which tells PowerShell to take the results of one command and send it to the next command. Here is an example command that displays only those user accounts that have an unspecified usage location:
  
```powershell
Get-MgUser | Where UsageLocation -eq $Null

Este comando indica ao PowerShell para:

1. Obtenha todas as informações sobre as contas de utilizador (Get-MgUser) e envie-as para o comando seguinte (|).

2. 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"

Consulte também

Gerir contas de utilizador, licenças e grupos do Microsoft 365 com o PowerShell

Gerir o Microsoft 365 com o PowerShell

Introdução ao PowerShell para Microsoft 365