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 Microsoft Graph PowerShell 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.
Criar contas 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"
Criar uma conta de usuário individual
Para criar uma conta individual, use a seguinte sintaxe:
$PasswordProfile = New-Object -TypeName Microsoft.Graph.PowerShell.Models.MicrosoftGraphPasswordProfile
$PasswordProfile.Password = "<user account password>"
New-MgUser -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 John Doe.
$PasswordProfile = New-Object -TypeName Microsoft.Graph.PowerShell.Models.MicrosoftGraphPasswordProfile
$PasswordProfile.Password = "3Rv0y1q39/chsy"
New-MgUser -DisplayName "John Doe" -GivenName "John" -Surname "Doe" -UserPrincipalName johnd@contoso.onmicrosoft.com -UsageLocation "US" -MailNickname "johnd" -PasswordProfile $PasswordProfile -AccountEnabled $true
Criar várias contas de usuários
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,MailNickname ClaudeL@contoso.onmicrosoft.com,Claude,Loiselle,Claude Loiselle,US,claudel LynneB@contoso.onmicrosoft.com,Lynne,Baxter,Lynne Baxter,US,lynneb ShawnM@contoso.onmicrosoft.com,Shawn,Melendez,Shawn Melendez,US,shawnm
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.
Este exemplo cria contas de usuário do arquivoC:\temp\NewAccounts.csv e registra os resultados em um arquivo chamado C:\temp\NewAccountResults.csv.
# Import the CSV file $users = Import-Csv -Path "C:\temp\NewAccounts.csv" # Create a password profile $PasswordProfile = @{ Password = 'Password123' } # Loop through each user in the CSV file foreach ($user in $users) { # Create a new user $newUser = New-MgUser -DisplayName $user.DisplayName -GivenName $user.FirstName -Surname $user.LastName -UserPrincipalName $user.UserPrincipalName -UsageLocation $user.UsageLocation -MailNickname $user.MailNickname -PasswordProfile $passwordProfile -AccountEnabled # Assign a license to the new user $e5Sku = Get-MgSubscribedSku -All | Where SkuPartNumber -eq 'SPE_E5' Set-MgUserLicense -UserId $newUser.Id -AddLicenses @{SkuId = $e5Sku.SkuId} -RemoveLicenses @() } # Export the results to a CSV file $users | Export-Csv -Path "C:\temp\NewAccountResults.csv" -NoTypeInformation
Examine o arquivo de saída para conferir os resultados.
Confira também
Gerenciar contas de usuário, licenças e grupos do Microsoft 365 com o PowerShell
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de