Partilhar via

Criar contas de utilizador do Microsoft 365 com o PowerShell

  • Artigo

Este artigo aplica-se 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. 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 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.

Nota

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

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.

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 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

  1. 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.

  2. 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

  3. 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