Criar contas de utilizador do Microsoft 365 com o PowerShell

Artigo
03/05/2024

Este artigo aplica-se tanto a Microsoft 365 Enterprise como a 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. Veja a tabela seguinte.

Nome da propriedade	Necessá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.
NomePróprio	Não
Apelido	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. Tem 30 dias para licenciar a conta de utilizador depois de a criar.
Palavra-passe	Não	Se não especificar uma palavra-passe, é atribuída uma palavra-passe aleatória à conta de utilizador e a palavra-passe é 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 o 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.

Nota

Veja 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

Nota

O módulo do Azure Active Directory está a ser substituído pelo SDK do PowerShell do Microsoft Graph. Pode utilizar o SDK do PowerShell do Microsoft Graph para aceder a todas as APIs do Microsoft Graph. Para obter mais informações, veja Introdução ao SDK do PowerShell do Microsoft Graph.

Em primeiro lugar, utilize uma conta de administrador do MICROSOFT ENTRA DC, Administração da Aplicação cloud ou Administrador globalpara 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 Graph API de referência "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 utilizador individual

Para criar uma conta individual, utilize 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 utilizador

Crie um ficheiro de valores separados por vírgulas (CSV) que contenha as informações necessárias da conta de utilizador. 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
```
Nota

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

Reveja o ficheiro de saída para ver os resultados.

Consulte também

Gerir contas de utilizador, licenças e grupos do Microsoft 365 com o PowerShell

Gerir o Microsoft 365 com o PowerShell

Introdução ao PowerShell para Microsoft 365