Microsoft 365-gebruikersaccounts maken met PowerShell
Dit artikel is van toepassing op Microsoft 365 Enterprise en Office 365 Enterprise.
U kunt Microsoft Graph PowerShell gebruiken om efficiënt gebruikersaccounts te maken, inclusief meerdere accounts.
Wanneer u gebruikersaccounts maakt in PowerShell, zijn bepaalde accounteigenschappen altijd vereist. Andere eigenschappen zijn niet vereist, maar wel belangrijk. Zie de volgende tabel.
| Eigenschapsnaam | Vereist? | Beschrijving |
|---|---|---|
|
DisplayName |
Ja |
Dit is de weergavenaam die wordt gebruikt in Microsoft 365-services. Bijvoorbeeld Caleb Sills. |
|
UserPrincipalName |
Ja |
Dit is de accountnaam die wordt gebruikt om u aan te melden bij Microsoft 365-services. Bijvoorbeeld CalebS@contoso.onmicrosoft.com. |
|
Voornaam |
Neen |
|
|
Achternaam |
Neen |
|
|
LicenseAssignment |
Neen |
Dit is het licentieplan (ook wel het licentieplan of SKU genoemd) van waaruit een beschikbare licentie wordt toegewezen aan het gebruikersaccount. De licentie definieert de Microsoft 365-services die beschikbaar zijn voor het account. U hoeft geen licentie toe te wijzen aan een gebruiker wanneer u het account maakt, maar het account moet een licentie hebben voor toegang tot Microsoft 365-services. Nadat u het gebruikersaccount hebt gemaakt, hebt u 30 dagen de tijd om een licentie te verlenen. |
|
Password |
Neen |
Als u geen wachtwoord opgeeft, wordt een willekeurig wachtwoord toegewezen aan het gebruikersaccount en is het wachtwoord zichtbaar in de resultaten van de opdracht. Als u een wachtwoord opgeeft, moet het bestaan uit 8 tot 16 ASCII-teksttekens van de volgende typen: kleine letters, hoofdletters, cijfers en symbolen. |
|
UsageLocation |
Neen |
Dit is een geldige ISO 3166-1 alfa-2-landcode. Bijvoorbeeld VS voor de Verenigde Staten en FR voor Frankrijk. Het is belangrijk om deze waarde op te geven, omdat sommige Microsoft 365-services niet beschikbaar zijn in bepaalde landen/regio's. U kunt geen licentie toewijzen aan een gebruikersaccount, tenzij deze waarde is geconfigureerd voor het account. Zie Over licentiebeperkingen voor meer informatie. |
Opmerking
Zie ook Meer informatie over het maken van gebruikersaccounts met behulp van het Microsoft 365-beheercentrum.
Zie Gebruikers en groepen beheren voor een lijst met aanvullende resources.
Microsoft 365-gebruikersaccounts maken met Microsoft Graph PowerShell
Opmerking
De Azure Active Directory-module wordt vervangen door de Microsoft Graph PowerShell SDK. U kunt de Microsoft Graph PowerShell SDK gebruiken voor toegang tot alle Microsoft Graph API's. Zie Aan de slag met de Microsoft Graph PowerShell SDK voor meer informatie.
Gebruik eerst een Microsoft Entra DC-beheerdersaccount of cloudtoepassingsbeheerder om verbinding te maken met uw Microsoft 365-tenant. Voor de cmdlets in dit artikel is het machtigingsbereik User.ReadWrite.All of een van de andere machtigingen vereist die worden vermeld op de Graph API-referentiepagina 'List subscribedSkus'. Voor sommige opdrachten in dit artikel zijn mogelijk verschillende machtigingsbereiken vereist, in welk geval dit wordt vermeld in de relevante sectie.
Connect-MgGraph -Scopes "User.ReadWrite.All"
Een afzonderlijk gebruikersaccount maken
Gebruik de volgende syntaxis om een afzonderlijk account te maken:
$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
In dit voorbeeld wordt een account gemaakt voor de Amerikaanse gebruiker 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
Meerdere gebruikersaccounts maken
Maak een csv-bestand (door komma's gescheiden waarden) dat de vereiste gebruikersaccountgegevens bevat. Bijvoorbeeld:
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,shawnmOpmerking
De kolomnamen en de bijbehorende volgorde in de eerste rij van het CSV-bestand zijn willekeurig. Zorg er echter voor dat de volgorde van de gegevens in de rest van het bestand overeenkomt met de volgorde van de kolomnamen. En gebruik de kolomnamen voor de parameterwaarden in de PowerShell voor Microsoft 365-opdracht.
In dit voorbeeld worden gebruikersaccounts gemaakt op basis van het bestandC:\temp\NewAccounts.csv en worden de resultaten geregistreerd in een bestand met de naam 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" -NoTypeInformationControleer het uitvoerbestand om de resultaten te bekijken.
Zie ook
Microsoft 365-gebruikersaccounts, -licenties en -groepen beheren met PowerShell