New-AzureADUser
Hiermee maakt u een Azure AD-gebruiker.
Syntaxis
New-AzureADUser
[-ExtensionProperty <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
-AccountEnabled <Boolean>
[-AgeGroup <String>]
[-City <String>]
[-CompanyName <String>]
[-ConsentProvidedForMinor <String>]
[-Country <String>]
[-CreationType <String>]
[-Department <String>]
-DisplayName <String>
[-FacsimileTelephoneNumber <String>]
[-GivenName <String>]
[-IsCompromised <Boolean>]
[-ImmutableId <String>]
[-JobTitle <String>]
[-MailNickName <String>]
[-Mobile <String>]
[-OtherMails <System.Collections.Generic.List`1[System.String]>]
[-PasswordPolicies <String>]
-PasswordProfile <PasswordProfile>
[-PhysicalDeliveryOfficeName <String>]
[-PostalCode <String>]
[-PreferredLanguage <String>]
[-ShowInAddressList <Boolean>]
[-SignInNames <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.SignInName]>]
[-State <String>]
[-StreetAddress <String>]
[-Surname <String>]
[-TelephoneNumber <String>]
[-UsageLocation <String>]
[-UserPrincipalName <String>]
[-UserState <String>]
[-UserStateChangedOn <String>]
[-UserType <String>]
[<CommonParameters>]
Description
Met de cmdlet New-AzureADUser maakt u een gebruiker in Azure Active Directory (Azure AD).
Voorbeelden
Voorbeeld 1: Een gebruiker maken
$PasswordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
$PasswordProfile.Password = "<Password>"
New-AzureADUser -DisplayName "New User" -PasswordProfile $PasswordProfile -UserPrincipalName "NewUser@contoso.com" -AccountEnabled $true -MailNickName "Newuser"
ObjectId DisplayName UserPrincipalName UserType
-------- ----------- ----------------- --------
5e8b0f4d-2cd4-4e17-9467-b0f6a5c0c4d0 New user NewUser@contoso.com Member
Met deze opdracht maakt u een nieuwe gebruiker.
Parameters
-AccountEnabled
Geeft aan of het account van de gebruiker is ingeschakeld.
Type: | Boolean |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-AgeGroup
Hiermee geeft u de leeftijdsgroep van de gebruiker op.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-City
Hiermee geeft u de plaats van de gebruiker op.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-CompanyName
Hiermee geeft u de bedrijfsnaam van de gebruiker op.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-ConsentProvidedForMinor
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-Country
Hiermee geeft u het land of de regio van de gebruiker op.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-CreationType
Geeft aan of het gebruikersaccount een lokaal account is voor een Azure Active Directory B2C-tenant.
Mogelijke waarden zijn LocalAccount
en null
.
Wanneer u een lokaal account maakt, is de eigenschap vereist en moet u deze instellen op LocalAccount
.
Wanneer u een werk- of schoolaccount maakt, moet u de eigenschap niet opgeven of instellen op null
.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-Department
Hiermee geeft u de afdeling van de gebruiker op.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-DisplayName
Hiermee geeft u de weergavenaam van de gebruiker op.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-ExtensionProperty
Type: | Dictionary<TKey,TValue>[System.String,System.String] |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-FacsimileTelephoneNumber
Hiermee geeft u het telefoonnummer van de gebruiker op.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-GivenName
Hiermee geeft u de opgegeven naam van de gebruiker.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-ImmutableId
Deze eigenschap wordt gebruikt om een on-premises Active Directory-gebruikersaccount te koppelen aan hun Azure AD-gebruikersobject. Deze eigenschap moet worden opgegeven bij het maken van een nieuw gebruikersaccount in graph als u een federatief domein gebruikt voor de eigenschap userPrincipalName (UPN) van de gebruiker.
Belangrijk: de $
tekens en _
kunnen niet worden gebruikt bij het opgeven van deze eigenschap.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-IsCompromised
Geeft aan of deze gebruiker is gecompromitteerd.
Type: | Boolean |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-JobTitle
Hiermee geeft u de functietitel van de gebruiker op.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-MailNickName
Hiermee geeft u de e-mailbijnaam van de gebruiker op.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-Mobile
Hiermee geeft u het mobiele telefoonnummer van de gebruiker op.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-OtherMails
Een lijst met extra e-mailadressen voor de gebruiker. Bijvoorbeeld bob@contoso.com
, Robert@fabrikam.com
.
Type: | List<T>[String] |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-PasswordPolicies
Hiermee geeft u wachtwoordbeleid voor de gebruiker op.
Deze waarde is een opsomming met één mogelijke waarde is DisableStrongPassword
, waardoor zwakkere wachtwoorden dan het standaardbeleid kunnen worden opgegeven.
DisablePasswordExpiration
kan ook worden opgegeven.
De twee kunnen samen worden opgegeven; bijvoorbeeld: 'DisablePasswordExpiration, DisableStrongPassword'.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-PasswordProfile
Hiermee geeft u het wachtwoordprofiel van de gebruiker op.
Houd er rekening mee dat het parametertype voor deze parameter is PasswordProfile
.
Als u een parameter van dit type wilt doorgeven, moet u eerst;
- maak een variabele in PowerShell met het volgende type:
$PasswordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
- Stel de waarde van het wachtwoord in deze variabele in:
$PasswordProfile.Password = "\<Password\>"
- Geef ten slotte deze variabele door aan de cmdlet:
New-AzureADUser -PasswordProfile $PasswordProfile ...
Andere kenmerken die kunnen worden ingesteld in het PasswordProfile zijn:
-
$PasswordProfile.EnforceChangePasswordPolicy
- een booleaanse waarde die aangeeft dat het wachtwoordbeleid voor deze gebruiker is in- of uitgeschakeld. -
$PasswordProfile.ForceChangePasswordNextLogin
- een booleaanse waarde die aangeeft dat de gebruiker het wachtwoord moet wijzigen bij de volgende aanmelding.
Type: | PasswordProfile |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-PhysicalDeliveryOfficeName
Hiermee geeft u de fysieke naam van het bezorgkantoor van de gebruiker op.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-PostalCode
Hiermee geeft u de postcode van de gebruiker.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-PreferredLanguage
Hiermee geeft u de voorkeurstaal van de gebruiker op.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-ShowInAddressList
Indien waar, geeft u deze gebruiker weer in de adreslijst.
Type: | Boolean |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-SignInNames
Hiermee geeft u de verzameling aanmeldingsnamen voor een lokaal account in een Azure Active Directory B2C-tenant.
Elke aanmeldingsnaam moet uniek zijn binnen het bedrijf/de tenant. De eigenschap moet worden opgegeven wanneer u een lokale accountgebruiker maakt. Geef deze niet op wanneer u een werk- of schoolaccount maakt.
Type: | List<T>[Microsoft.Open.AzureAD.Model.SignInName] |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-State
Hiermee geeft u de status van de gebruiker op.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-StreetAddress
Hiermee geeft u het adres van de gebruiker op.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-Surname
Hiermee geeft u de achternaam van de gebruiker op.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-TelephoneNumber
Hiermee geeft u een telefoonnummer.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-UsageLocation
Een land- of regiocode van twee letters (ISO-norm 3166).
Dit is vereist voor gebruikers aan wie licenties worden toegewezen vanwege wettelijke vereisten om de beschikbaarheid van services in landen en regio's te controleren.
Voorbeelden zijn: US
, JP
en GB
.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-UserPrincipalName
Hiermee geeft u de principal name (UPN) van de gebruiker op.
De UPN is een aanmeldingsnaam in internetstijl voor de gebruiker op basis van de internetstandaard RFC 822.
Dit moet standaard worden toegewezen aan de e-mailnaam van de gebruiker.
De algemene indeling is alias@domain
.
Voor werk- of schoolaccounts moet het domein aanwezig zijn in de verzameling geverifieerde domeinen van de tenant. Deze eigenschap is vereist wanneer een werk- of schoolaccount wordt gemaakt; dit is optioneel voor lokale accounts.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-UserState
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-UserStateChangedOn
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-UserType
Een tekenreekswaarde die kan worden gebruikt voor het classificeren van gebruikerstypen in uw directory, zoals 'Lid' en 'Gast'.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
Notities
Zie de migratiehandleiding voor New-AzureADUser naar Microsoft Graph PowerShell.