Criar contas 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 PowerShell para o Microsoft 365 para criar contas de usuário com eficiência, incluindo várias contas.

Quando você cria contas de usuário no PowerShell, determinadas propriedades da conta são sempre necessárias. Outras propriedades não são necessárias, mas são importantes. Consulte a tabela a seguir.

Nome da propriedade Obrigatório? Descrição
DisplayName
Sim
Este é o nome de exibição usado nos serviços do Microsoft 365. Por exemplo, Caleb Sills.
UserPrincipalName
Sim
Este é o nome da conta que é usado para entrar nos serviços do Microsoft 365. Por exemplo, CalebS@contoso.onmicrosoft.com.
FirstName
Não
LastName
Não
LicenseAssignment
Não
Esse é o plano de licenciamento (também conhecido como plano de licença ou SKU) do qual uma licença disponível é atribuída à conta de usuário. A licença define os serviços do Microsoft 365 que estão disponíveis para a conta. Você não precisa atribuir uma licença a um usuário ao criar a conta, mas a conta deve ter uma licença para acessar os serviços do Microsoft 365. Você tem 30 dias para licenciar a conta de usuário depois de criá-la.
Password
Não
Caso não especifique uma senha, nosso sistema atribuirá uma senha aleatória para a conta do usuário e a senha ficará visível nos resultados do comando. Se você especificar uma senha, ela precisa ser de 8 a 16 caracteres de texto ASCII dos seguintes tipos: letras minúsculas, letras maiúsculas, números e símbolos.
UsageLocation
Não
Este é um código de país iso 3166-1 alfa-2 válido. Por exemplo, EUA para o Estados Unidos e FR para a França. É importante fornecer esse valor, pois alguns serviços do Microsoft 365 não estão disponíveis em determinados países/regiões. Você não pode atribuir uma licença a uma conta de usuário, a menos que a conta tenha esse valor configurado. Para obter mais informações, consulte Sobre restrições de licença.

Observação

Consulte Também Saiba como criar contas de usuário usando o Centro de administração do Microsoft 365.

Para obter uma lista de recursos adicionais, consulte Gerenciar usuários e grupos.

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

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

Depois de se conectar, use a seguinte sintaxe para criar uma conta individual:

$PasswordProfile=New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
$PasswordProfile.Password="<user account password>"
New-AzureADUser -DisplayName "<display name>" -GivenName "<first name>" -SurName "<last name>" -UserPrincipalName <sign-in name> -UsageLocation <ISO 3166-1 alpha-2 country code> -MailNickName <mailbox name> -PasswordProfile $PasswordProfile -AccountEnabled $true

Este exemplo cria uma conta para o usuário norte-americano Caleb Sills:

$PasswordProfile=New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
$PasswordProfile.Password="3Rv0y1q39/chsy"
New-AzureADUser -DisplayName "Caleb Sills" -GivenName "Caleb" -SurName "Sills" -UserPrincipalName calebs@contoso.onmicrosoft.com -UsageLocation US -MailNickName calebs -PasswordProfile $PasswordProfile -AccountEnabled $true

Use o módulo Microsoft Azure Active Directory para Windows PowerShell

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

Criar uma conta de usuário individual

Para criar uma conta individual, use a seguinte sintaxe:

New-MsolUser -DisplayName <display name> -FirstName <first name> -LastName <last name> -UserPrincipalName <sign-in name> -UsageLocation <ISO 3166-1 alpha-2 country code> -LicenseAssignment <licensing plan name> [-Password <Password>]

Observação

O PowerShell Core não dá suporte ao módulo Microsoft Azure Active Directory para Windows PowerShell módulo e cmdlets que têm o Msol em seu nome. Execute esses cmdlets do Windows PowerShell.

Para listar os nomes do plano de licenciamento disponíveis, use este comando:

Get-MsolAccountSku

Este exemplo cria uma conta para o usuário norte-americano Caleb Sills e atribui uma licença do contoso:ENTERPRISEPACK plano de licenciamento (Office 365 Enterprise E3).

New-MsolUser -DisplayName "Caleb Sills" -FirstName Caleb -LastName Sills -UserPrincipalName calebs@contoso.onmicrosoft.com -UsageLocation US -LicenseAssignment contoso:ENTERPRISEPACK

Criar várias contas de usuários

  1. Crie um arquivo CSV (arquivo de valores separados por vírgula ) que inclua as informações necessárias da conta do usuário. Por exemplo:

    UserPrincipalName,FirstName,LastName,DisplayName,UsageLocation,AccountSkuId
    ClaudeL@contoso.onmicrosoft.com,Claude,Loiselle,Claude Loiselle,US,contoso:ENTERPRISEPACK
    LynneB@contoso.onmicrosoft.com,Lynne,Baxter,Lynne Baxter,US,contoso:ENTERPRISEPACK
    ShawnM@contoso.onmicrosoft.com,Shawn,Melendez,Shawn Melendez,US,contoso:ENTERPRISEPACK
    

    Observação

    Os nomes de coluna e sua ordem na primeira linha do arquivo CSV são arbitrários. Mas verifique se a ordem dos dados no restante do arquivo corresponde à ordem dos nomes de coluna. E use os nomes de coluna para os valores de parâmetro no comando PowerShell para Microsoft 365.

  2. Use a seguinte sintaxe:

     Import-Csv -Path <Input CSV File Path and Name> | foreach {New-MsolUser -DisplayName $_.DisplayName -FirstName $_.FirstName -LastName $_.LastName -UserPrincipalName $_.UserPrincipalName -UsageLocation $_.UsageLocation -LicenseAssignment $_.AccountSkuId [-Password $_.Password]} | Export-Csv -Path <Output CSV File Path and Name>
    

    Este exemplo cria contas de usuário do arquivo C:\My Documents\NewAccounts.csv e registra os resultados em um arquivo chamado C:\My Documents\NewAccountResults.csv.

    Import-Csv -Path "C:\My Documents\NewAccounts.csv" | foreach {New-MsolUser -DisplayName $_.DisplayName -FirstName $_.FirstName -LastName $_.LastName -UserPrincipalName $_.UserPrincipalName -UsageLocation $_.UsageLocation -LicenseAssignment $_.AccountSkuId} | Export-Csv -Path "C:\My Documents\NewAccountResults.csv"
    
  3. Examine o arquivo de saída para conferir os resultados. Não especificamos senhas, portanto, as senhas aleatórias geradas pelo Microsoft 365 estão visíveis no arquivo de saída.

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 PowerShell para o Microsoft 365