Configurar as propriedades da conta de utilizador do Microsoft 365 com o PowerShell

Este artigo aplica-se ao Microsoft 365 Enterprise e ao Office 365 Enterprise.

Pode utilizar o centro de administração do Microsoft 365 para configurar propriedades para as contas de utilizador do seu inquilino do Microsoft 365. No PowerShell, também pode fazê-lo, além de outras coisas que não pode fazer no centro de administração.

Configurar as propriedades da conta de utilizador do Microsoft 365 com o Microsoft Graph PowerShell

Primeiro, utilize uma conta de administrador do Microsoft Entra DC ou de Administrador de Aplicações na Cloud para ligar ao seu inquilino do Microsoft 365. Os cmdlets neste artigo requerem o âmbito de permissão User.ReadWrite.All ou uma das outras permissões listadas na página de referência da Graph API "List subscribedSkus". Alguns comandos neste artigo podem exigir âmbitos de permissão diferentes, caso em que será indicado na secção relevante.

Connect-MgGraph -Scopes "User.ReadWrite.All"

Alterar as propriedades de uma conta de utilizador específica

Identifica a conta com o parâmetro -ObjectID e define ou altera propriedades específicas com parâmetros adicionais. Eis uma lista dos parâmetros mais comuns:

• -Department "<nome> do departamento"

• -DisplayName "<nome> de utilizador completo"

• -FacsimilieTelephoneNumber "<número> de fax"

• -GivenName "<nome próprio> do utilizador"

• -Apelido de "<apelido> de utilizador"

• -Mobile "<número> de telemóvel"

• -JobTitle "<cargo>"

• -PreferredLanguage "<language>"

• -StreetAddress "<street address>"

• -City "<nome da> cidade"

• -Estado "<nome> do estado"

• -Código Postal "<código> postal"

• -País "<nome> do país"

• -TelefoneNúmero "<número> de telefone do escritório"

• -UsageLocation "<Código de país ou região de 2 carateres>"

  Este é o iso 3166-1 alfa-2 (A2) código de país ou região de duas letras.

Para apresentar o Nome Principal de Utilizador (UPN) das suas contas de utilizador, execute o seguinte comando.

Get-MgUser -All | Sort-Object UserPrincipalName | Select-Object UserPrincipalName | More

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. Ordene a lista de UPNs alfabeticamente (Ordenar UserPrincipalName) e envie-a para o comando seguinte (|).

3. Apresentar apenas a propriedade UPN para cada conta (Selecione UserPrincipalName).

4. Apresentar um ecrã de cada vez (Mais).

Para apresentar o UPN de uma conta com base no respetivo nome a apresentar (nome próprio e apelido), execute os seguintes comandos. Preencha a variável $userName e remova os < carateres e > :

$userName="<Display name>"
Write-Host (Get-MgUser -All | where {$_.DisplayName -eq $userName}).UserPrincipalName

Este exemplo apresenta o UPN da conta de utilizador que tem o nome a apresentar Caleb Sills.

$userName="Caleb Sills"
Write-Host (Get-MgUser -All | where {$_.DisplayName -eq $userName}).UserPrincipalName

Ao utilizar uma variável de $upn , pode efetuar alterações a contas individuais com base no respetivo nome a apresentar. Eis um exemplo que define a localização de utilização de Belinda Newman para França. No entanto, especifica o nome a apresentar em vez do UPN:

$userName="Belinda Newman"
$upn=(Get-MgUser | where {$_.DisplayName -eq $userName}).UserPrincipalName
Update-MgUser -UserId $upn -UsageLocation "FR"

Alterar propriedades de todas as contas de utilizador

Para alterar as propriedades de todos os utilizadores, pode utilizar uma combinação dos cmdlets Get-MgUser e Update-MgUser . O exemplo seguinte altera a localização de utilização de todos os utilizadores para França:

Get-MgUser | ForEach-Object { Update-MgUser -UserId $_.Id -UsageLocation "FR" }

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. Defina a localização do utilizador como França (Update-MgUser -UsageLocation FR).

Alterar propriedades de um conjunto específico de contas de utilizador

Para alterar as propriedades de um conjunto específico de contas de utilizador, pode utilizar uma combinação dos cmdlets Get-MgUser, Where e Update-MgUser . O exemplo seguinte altera a localização de utilização de todos os utilizadores no departamento de Contabilidade para França:

Get-MgUser -All | Where-Object {$_.Department -eq "Accounting"} | ForEach-Object {Update-MgUser -UserId $_.Id -UsageLocation "FR"}

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 a respetiva propriedade Departamento definida como "Contabilidade" (Em que {$_. Department -eq "Accounting"}) e envie as informações resultantes para o comando seguinte (|).

3. Defina a localização do utilizador como França (Update-MgUser -UsageLocation FR).

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