Criar contas de utilizador do Microsoft 365 com o PowerShell

Artigo
06/18/2024

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

Pode utilizar o Microsoft Graph PowerShell para criar contas de utilizador de forma eficiente, incluindo várias contas.

Quando cria contas de utilizador no PowerShell, são sempre necessárias determinadas propriedades de conta. 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 a apresentar utilizado nos serviços do Microsoft 365. Por exemplo, Caleb Sills.
UserPrincipalName	Sim	Este é o nome de conta utilizado para iniciar sessão nos serviços do Microsoft 365. Por exemplo, CalebS@contoso.onmicrosoft.com.
FirstName	Não
LastName	Não
LicenseAssignment	Não	Este é o plano de licenciamento (também conhecido como plano de licença ou SKU) a partir do qual é atribuída uma licença disponível à conta de utilizador. A licença define os serviços do Microsoft 365 que estão disponíveis para a conta. Não tem de atribuir uma licença a um utilizador quando cria a conta, mas a conta tem de ter uma licença para aceder aos 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 especificar uma palavra-passe, esta tem de ser de 8 a 16 carateres 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, E.U.A . para os Estados Unidos e FR para França. É importante fornecer este valor, porque alguns serviços do Microsoft 365 não estão disponíveis em determinados países/regiões. Não pode atribuir uma licença a uma conta de utilizador, a menos que a conta tenha este valor configurado. Para obter mais informações, veja Acerca das restrições de licenças.

Observação

Consulte também Saiba como criar contas de utilizador com o centro de administração do Microsoft 365.

Para obter uma lista de recursos adicionais, veja Gerir utilizadores e grupos.

Criar contas de utilizador do Microsoft 365 com o Microsoft Graph PowerShell

Observação

O módulo do Azure Active Directory está a ser substituído pelo SDK do PowerShell do Microsoft Graph. 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, utilize uma conta de administrador do Microsoft Entra DC ou de Administrador de Aplicações na Cloud para ligar ao seu inquilino do Microsoft 365. Os cmdlets neste artigo requerem o âmbito de permissão User.ReadWrite.All ou uma das outras permissões listadas na página de referência da Graph API "List subscribedSkus". Alguns comandos neste artigo podem exigir âmbitos de permissão diferentes, caso em que será indicado na secçã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 utilizador 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 das colunas e a respetiva ordem na primeira linha do ficheiro CSV são arbitrários. No entanto, certifique-se de que a ordem dos dados no resto do ficheiro corresponde à ordem dos nomes das colunas. Utilize também os nomes das colunas para os valores dos parâmetros no comando do PowerShell para Microsoft 365.

Este exemplo cria contas de utilizador a partir do ficheiroC:\temp\NewAccounts.csv e regista os resultados num ficheiro com o nome 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

Gerenciar o Microsoft 365 com o PowerShell

Introdução ao PowerShell para o Microsoft 365

Compartilhar via