Configurar as propriedades da conta de usuário do Microsoft 365 com o PowerShell

Esse artigo se aplica ao Microsoft 365 Enterprise e ao Office 365 Enterprise.

Você pode usar o Centro de administração do Microsoft 365 para configurar propriedades para as contas de usuário do seu locatário do Microsoft 365. No PowerShell, você também pode fazer isso, além de algumas outras coisas que não pode fazer no centro de administração.

Use o PowerShell do Azure Active Directory para o módulo do gráfico

Para configurar propriedades para contas de usuário no módulo Azure Active Directory PowerShell para Graph, use o cmdlet Set-AzureADUser e especifique as propriedades a serem definidas ou alteradas.

Primeiro, conecte-se ao seu locatário do Microsoft 365.

Alterar propriedades de uma conta de usuário específica

Você identifica a conta com o parâmetro -ObjectID e define ou altera propriedades específicas usando parâmetros adicionais. Aqui está uma lista dos parâmetros mais comuns:

  • -Department "<department name>"

  • -DisplayName "<full user name>"

  • -FacsimilieTelephoneNumber "<fax number>"

  • -GivenName "<user first name>"

  • -Sobrenome "<user last name>"

  • -Mobile "<mobile phone number>"

  • -JobTitle "<job title>"

  • -PreferredLanguage "<language>"

  • -StreetAddress "<street address>"

  • -City "<city name>"

  • -State "<state name>"

  • -PostalCode "<postal code>"

  • -Country "<country name>"

  • -TelephoneNumber "<office phone number>"

  • -UsageLocation "<2-character country or region code>"

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

Para obter parâmetros adicionais, consulte Set-AzureADUser.

Observação

Antes de atribuir licenças a uma conta de usuário, você deve atribuir um local de uso.

Para exibir o Nome UPN para suas contas de usuário, execute o comando a seguir.

Get-AzureADUser | Sort UserPrincipalName | Select UserPrincipalName | More

Este comando instrui o PowerShell a:

  1. Obtenha todas as informações sobre as contas de usuário (Get-AzureADUser) e envie-as para o próximo comando (|).

  2. Classifique a lista de nomes de entidades de usuário em ordem alfabética (Classificar UserPrincipalName) e envie-a para o próximo comando (|).

  3. Exibe apenas a propriedade Nome Principal do Usuário para cada conta (Selecione UserPrincipalName).

  4. Exibir uma tela por vez (Mais).

Para exibir o Nome UPN de uma conta com base em seu nome de exibição (nome e sobrenome), execute os comandos a seguir. Preencha a variável $userName e remova os < and > caracteres:

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

Este exemplo exibe o Nome UPN da conta de usuário que tem o nome de exibição Caleb Sills.

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

Usando uma variável $upn , você pode fazer alterações em contas individuais com base no nome de exibição. Aqui está um exemplo que define a localização de uso de Belinda Newman como França. Mas especifica seu nome de exibição em vez de seu Nome UPN:

$userName="Belinda Newman"
$upn=(Get-AzureADUser | where {$_.DisplayName -eq $userName}).UserPrincipalName
Set-AzureADUser -ObjectID $upn -UsageLocation FR

Alterar as propriedades de todas as contas de usuário

Para alterar as propriedades de todos os usuários, você pode usar uma combinação dos cmdlets Get-AzureADUser e Set-AzureADUser . O exemplo a seguir altera o local de uso de todos os usuários para a França:

Get-AzureADUser -All $true | Set-AzureADUser -UsageLocation FR

Este comando instrui o PowerShell a:

  1. Obtenha todas as informações sobre as contas de usuário (Get-AzureADUser) e envie-as para o próximo comando (|).

  2. Defina o local do usuário como França (Set-AzureADUser -UsageLocation FR).

Alterar propriedades de um conjunto específico de contas de usuário

Para alterar as propriedades de um conjunto específico de contas de usuário, você pode usar uma combinação dos cmdlets Get-AzureADUser, Where e Set-AzureADUser . O exemplo a seguir altera o local de uso de todos os usuários no departamento de Contabilidade para a França:

Get-AzureADUser | Where {$_.Department -eq "Accounting"} | Set-AzureADUser -UsageLocation FR

Este comando instrui o PowerShell a:

  1. Obtenha todas as informações sobre as contas de usuário (Get-AzureADUser) e envie-as para o próximo comando (|).

  2. Localize todas as contas de usuário que têm sua propriedade Department definida como "Contabilidade" (em que {$_. Department -eq "Accounting"}) e envie as informações resultantes para o próximo comando (|).

  3. Defina o local do usuário como França (Set-AzureADUser -UsageLocation FR).

Use o Módulo Microsoft Azure Active Directory para Windows PowerShell.

Para configurar propriedades para contas de usuário com o módulo Microsoft Azure Active Directory para Windows PowerShell, use o cmdlet Set-MsolUser e especifique as propriedades a serem definidas ou alteradas.

Primeiro, conecte-se ao seu locatário do Microsoft 365.

Observação

O PowerShell Core não oferece suporte ao Módulo Microsoft Azure Active Directory para Windows PowerShell, módulo e cmdlets com Msol em seus nomes. Execute esses cmdlets a partir do Windows PowerShell.

Alterar propriedades de uma conta de usuário específica

Para configurar propriedades para uma conta de usuário específica, use o cmdlet Set-MsolUser e especifique as propriedades a serem definidas ou alteradas.

Você identifica a conta com o parâmetro -UserPrincipalName e define ou altera propriedades específicas usando parâmetros adicionais. Aqui está uma lista dos parâmetros mais comuns.

  • -City "<city name>"

  • -Country "<country name>"

  • -Department "<department name>"

  • -DisplayName "<full user name>"

  • -Fax "<fax number>"

  • -FirstName "<user first name>"

  • -LastName "<user last name>"

  • -MobilePhone "<mobile phone number>"

  • -Office "<office location>"

  • -PhoneNumber "<office phone number>"

  • -PostalCode "<postal code>"

  • -PreferredLanguage "<language>"

  • -State "<state name>"

  • -StreetAddress "<street address>"

  • -Title "<title name>"

  • -UsageLocation "<2-character country or region code>"

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

Para obter parâmetros adicionais, consulte Set-MsolUser.

Para ver os nomes de entidade de usuário de todos os seus usuários, execute o seguinte comando:

Get-MSolUser | Sort UserPrincipalName | Select UserPrincipalName | More

Este comando instrui o PowerShell a:

  1. Obtenha todas as informações das contas de usuário (Get-MsolUser) e envie-as para o próximo comando (|).

  2. Classifique a lista de nomes de entidades de usuário em ordem alfabética (Classificar UserPrincipalName) e envie-a para o próximo comando (|).

  3. Exibe apenas a propriedade Nome Principal do Usuário para cada conta (Selecione UserPrincipalName).

  4. Exibir uma tela por vez (Mais).

Para exibir o Nome UPN de uma conta com base em seu nome de exibição (nome e sobrenome), execute os comandos a seguir. Preencha a variável $userName e remova os caracteres < and > .

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

Este exemplo exibe o Nome UPN do usuário chamado Caleb Sills:

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

Usando uma variável $upn , você pode fazer alterações em contas individuais com base no nome de exibição. Aqui está um exemplo que define a localização de uso de Belinda Newman como França, mas especifica seu nome de exibição em vez de seu Nome Upn principal:

$userName="<display name>"
$upn=(Get-MsolUser | where {$_.DisplayName -eq $userName}).UserPrincipalName
Set-MsolUser -UserPrincipalName $upn -UsageLocation FR

Alterar as propriedades de todas as contas de usuário

Para alterar as propriedades de todos os usuários, use uma combinação dos cmdlets Get-MsolUser e Set-MsolUser . O exemplo a seguir altera o local de uso de todos os usuários para a França:

Get-MsolUser | Set-MsolUser -UsageLocation FR

Este comando instrui o PowerShell a:

  1. Obtenha todas as informações das contas de usuário (Get-MsolUser) e envie-as para o próximo comando (|).

  2. Defina o local do usuário como França (Set-MsolUser -UsageLocation FR).

Alterar propriedades de um conjunto específico de contas de usuário

Para alterar as propriedades de um conjunto específico de contas de usuário, você pode usar uma combinação dos cmdlets Get-MsolUser, Where e Set-MsolUser . O exemplo a seguir altera o local de uso de todos os usuários no departamento de Contabilidade para a França:

Get-MsolUser | Where {$_.Department -eq "Accounting"} | Set-MsolUser -UsageLocation FR

Este comando instrui o PowerShell a:

  1. Obtenha todas as informações das contas de usuário (Get-MsolUser) e envie-as para o próximo comando (|).

  2. Localize todas as contas de usuário que têm sua propriedade Department definida como "Contabilidade" (em que {$_. Department -eq "Accounting"}) e envie as informações resultantes para o próximo comando (|).

  3. Defina o local do usuário como França (Set-MsolUser -UsageLocation FR).

Confira também

Gerenciar contas de usuário, licenças e grupos do Microsoft 365 com o PowerShell

Gerenciar o Microsoft 365 com o PowerShell

Introdução ao Windows PowerShell para o Microsoft 365