Criar Microsoft 365 de usuário com o PowerShellCreate Microsoft 365 user accounts with PowerShell

Esse artigo se aplica ao Microsoft 365 Enterprise e ao Office 365 Enterprise.This article applies to both Microsoft 365 Enterprise and Office 365 Enterprise.

Você pode usar o PowerShell para Microsoft 365 criar contas de usuário de forma eficiente, incluindo várias contas.You can use PowerShell for Microsoft 365 to efficiently create user accounts, including multiple accounts.

Quando você cria contas de usuário no PowerShell, determinadas propriedades de conta são sempre necessárias.When you create user accounts in PowerShell, certain account properties are always required. Outras propriedades não são necessárias, mas são importantes.Other properties aren't required but are important. Consulte a tabela a seguir.See the following table.

Nome da propriedadeProperty name Obrigatório?Required? DescriçãoDescription
DisplayNameDisplayName
SimYes
Esse é o nome de exibição usado nos serviços Microsoft 365 de exibição.This is the display name that's used in Microsoft 365 services. Por exemplo, Caleb Sills.For example, Caleb Sills.
UserPrincipalNameUserPrincipalName
SimYes
Esse é o nome da conta usado para entrar em serviços Microsoft 365.This is the account name that's used to sign in to Microsoft 365 services. Por exemplo, CalebS @ contoso.onmicrosoft.com.For example, CalebS@contoso.onmicrosoft.com.
FirstNameFirstName
NãoNo
LastNameLastName
NãoNo
LicenseAssignmentLicenseAssignment
NãoNo
Este é 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.This is the licensing plan (also known as the license plan or SKU) from which an available license is assigned to the user account. A licença define os serviços Microsoft 365 que estão disponíveis para a conta.The license defines the Microsoft 365 services that are available to the account. 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 Microsoft 365 serviços.You don't have to assign a license to a user when you create the account, but the account must have a license to access Microsoft 365 services. Você tem 30 dias para licenciar a conta de usuário depois de criá-la.You have 30 days to license the user account after you create it.
PasswordPassword
NãoNo
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.If you don't specify a password, a random password is assigned to the user account, and the password is visible in the results of the command. Se você especificar uma senha, ela precisará ser de 8 a 16 caracteres de texto ASCII dos seguintes tipos: letras minúsculas, letras maiúsculas, números e símbolos.If you specify a password, it needs to be 8 to 16 ASCII text characters of the following types: lowercase letters, uppercase letters, numbers, and symbols.
UsageLocationUsageLocation
NãoNo
Este é um código de país iso 3166-1 alfa-2 válido.This is a valid ISO 3166-1 alpha-2 country code. Por exemplo, EUA para os Estados Unidos e FR para França.For example, US for the United States, and FR for France. É importante fornecer esse valor, pois alguns serviços Microsoft 365 não estão disponíveis em determinados países.It's important to provide this value, because some Microsoft 365 services aren't available in certain countries. Você não pode atribuir uma licença a uma conta de usuário, a menos que a conta tenha esse valor configurado.You can't assign a license to a user account unless the account has this value configured. Para obter mais informações, consulte Sobre restrições de licença.For more information, see About license restrictions.

Observação

Saiba como criar contas de usuário usando o Microsoft 365 de administração.Learn how to create user accounts by using the Microsoft 365 admin center.

Para obter uma lista de recursos adicionais, consulte Gerenciar usuários e grupos.For a list of additional resources, see Manage users and groups.

Use o PowerShell do Azure Active Directory para o módulo do gráficoUse the Azure Active Directory PowerShell for Graph module

Primeiro, conecte-se ao seu Microsoft 365 locatário.First, connect to your Microsoft 365 tenant.

Depois de se conectar, use a seguinte sintaxe para criar uma conta individual:After you connect, use the following syntax to create an individual account:

$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 dos EUA Caleb Sills:This example creates an account for the US user 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.Use the Microsoft Azure Active Directory Module for Windows PowerShell

Primeiro, conecte-se ao seu Microsoft 365 locatário.First, connect to your Microsoft 365 tenant.

Criar uma conta de usuário individualCreate an individual user account

Para criar uma conta individual, use a seguinte sintaxe:To create an individual account, use the following syntax:

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 e cmdlets que têm Msol em seu nome.PowerShell Core doesn't support the Microsoft Azure Active Directory Module for Windows PowerShell module and cmdlets that have Msol in their name. Execute esses cmdlets do Windows PowerShell.Run these cmdlets from Windows PowerShell.

Para listar os nomes do plano de licenciamento disponível, use este comando:To list the available licensing plan names, use this command:

Get-MsolAccountSku

Este exemplo cria uma conta para o usuário dos EUA Caleb Sills e atribui uma licença do plano de licenciamento contoso:ENTERPRISEPACK (Office 365 Enterprise E3).This example creates an account for the US user Caleb Sills, and assigns a license from the contoso:ENTERPRISEPACK (Office 365 Enterprise E3) licensing plan.

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áriosCreate multiple user accounts

  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:Create a comma-separated value (CSV) file that contains the required user account information. For example:

    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 das colunas e sua ordem na primeira linha do arquivo CSV são arbitrários.The column names and their order in the first row of the CSV file are arbitrary. Mas certifique-se de que a ordem dos dados no restante do arquivo corresponde à ordem dos nomes das colunas.But make sure the order of the data in the rest of the file matches the order of the column names. E use os nomes de coluna para os valores de parâmetro no comando PowerShell para Microsoft 365.And use the column names for the parameter values in the PowerShell for Microsoft 365 command.

  2. Use a seguinte sintaxe:Use the following syntax:

     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.This example creates user accounts from the file C:\My Documents\NewAccounts.csv and logs the results in a file named 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.Review the output file to see the results. Não especificamos senhas, portanto, as senhas aleatórias que Microsoft 365 geradas ficam visíveis no arquivo de saída.We didn't specify passwords, so the random passwords that Microsoft 365 generated are visible in the output file.

Confira tambémSee also

Gerenciar contas de usuário, licenças e grupos do Microsoft 365 com o PowerShellManage Microsoft 365 user accounts, licenses, and groups with PowerShell

Gerenciar o Microsoft 365 com o PowerShellManage Microsoft 365 with PowerShell

Introdução ao PowerShell para o Microsoft 365Getting started with PowerShell for Microsoft 365