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

  • Artigo

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 locatário do Microsoft 365. No PowerShell, você também pode fazer isso, além de outras coisas que não pode fazer no centro de administração.

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

Observação

O módulo do Azure Active Directory está sendo substituído pelo SDK do Microsoft Graph PowerShell. Você pode usar o Microsoft Graph SDK do PowerShell para acessar todas as APIs do Microsoft Graph. Para saber mais, confira Introdução ao SDK do PowerShell do Microsoft Graph.

Primeiro, use um administrador Microsoft Entra DC, Administração de Aplicativo na Nuvem ou conta de administrador globalpara se conectar ao locatário do Microsoft 365. Os cmdlets neste artigo exigem o escopo de permissão User.ReadWrite.All ou uma das outras permissões listadas na página de referência 'List subscribedSkus' API do Graph. Alguns comandos neste artigo podem exigir escopos de permissão diferentes, nesse caso, isso será observado na seção relevante.

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

Alterar propriedades para 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:

  • -Departamento "<nome do> departamento"

  • -DisplayName "<nome> de usuário completo"

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

  • -GivenName "<nome de> usuário"

  • -Sobrenome "<sobrenome> do usuário"

  • -Celular "<número> de telefone celular"

  • -JobTitle "<job title>"

  • -PreferredLanguage "<language>"

  • -StreetAddress "<endereço> de rua"

  • -Cidade "<nome da> cidade"

  • -Estado "<nome> do estado"

  • -PostalCode "<código> postal"

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

  • -PhoneNumber "<número> de telefone do office"

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

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

Observação

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

Para exibir o UPN (Nome da Entidade de Usuário) para suas contas de usuário, execute o comando a seguir.

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

Este comando instrui o PowerShell a:

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

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

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

  4. Exiba uma tela por vez (Mais).

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

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

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

$userName="Caleb Sills"
Write-Host (Get-MgUser -All | 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 o local de uso de Belinda Newman para a França. Mas especifica seu nome de exibição em vez de seu UPN:

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

Alterar propriedades para todas as contas de usuário

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

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

Este comando instrui o PowerShell a:

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

  2. Defina a localização do usuário como França (Update-MgUser -UsageLocation FR).

Alterar propriedades para 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-MgUser, Where e Update-MgUser . O exemplo a seguir altera o local de uso de todos os usuários do departamento de Contabilidade para a França:

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

Este comando instrui o PowerShell a:

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

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

  3. Defina a localização do usuário como França (Update-MgUser -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