New-AzureADUser

Hiermee maakt u een Azure AD gebruiker.

Syntax

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
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-AgeGroup

Hiermee geeft u de leeftijdsgroep van de gebruiker op.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-City

Hiermee geeft u de plaats van de gebruiker op.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CompanyName

Hiermee geeft u de bedrijfsnaam van de gebruiker op.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ConsentProvidedForMinor

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Country

Hiermee geeft u het land of de regio van de gebruiker op.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Department

Hiermee geeft u de afdeling van de gebruiker op.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

Hiermee geeft u de weergavenaam van de gebruiker.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ExtensionProperty

Type:Dictionary<TKey,TValue>[System.String,System.String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FacsimileTelephoneNumber

Hiermee geeft u het telefoonnummer van de gebruiker op.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GivenName

Hiermee geeft u de opgegeven naam van de gebruiker.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ImmutableId

Deze eigenschap wordt gebruikt om een on-premises Active Directory gebruikersaccount te koppelen aan het 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IsCompromised

Geeft aan of deze gebruiker is gecompromitteerd.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobTitle

Hiermee geeft u de functie van de gebruiker op.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MailNickName

Hiermee geeft u de e-mailbijnaam van de gebruiker op.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Mobile

Hiermee geeft u het mobiele telefoonnummer van de gebruiker op.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PasswordPolicies

Hiermee geeft u wachtwoordbeleid voor de gebruiker.

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
Required:False
Accept pipeline input:False
Accept wildcard characters: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;

  1. maak een variabele in PowerShell met dit type:

$PasswordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile

  1. Stel de waarde van het wachtwoord in deze variabele in:

$PasswordProfile.Password = "\<Password\>"

  1. 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 bij de volgende aanmelding moet wijzigen.
Type:PasswordProfile
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PhysicalDeliveryOfficeName

Hiermee geeft u de naam van de fysieke levering kantoor van de gebruiker.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PostalCode

Hiermee geeft u de postcode van de gebruiker.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PreferredLanguage

Hiermee geeft u de voorkeurstaal van de gebruiker op.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ShowInAddressList

Indien Waar, geeft u deze gebruiker weer in de adreslijst.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 dit niet op wanneer u een werk- of schoolaccount maakt.

Type:List<T>[Microsoft.Open.AzureAD.Model.SignInName]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-State

Hiermee geeft u de status van de gebruiker op.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-StreetAddress

Hiermee geeft u het adres van de gebruiker op.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Surname

Hiermee geeft u de achternaam van de gebruiker op.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TelephoneNumber

Hiermee geeft u een telefoonnummer op.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UsageLocation

Een land- of regiocode van twee letters (ISO-standaard 3166).

Het is vereist voor gebruikers aan wie licenties worden toegewezen vanwege wettelijke vereisten om te controleren op de beschikbaarheid van services in landen en regio's. Voorbeelden zijn: US, JPen GB.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserPrincipalName

Hiermee geeft u de upn (principal name) van de gebruiker op.

De UPN is een aanmeldingsnaam in internetstijl voor de gebruiker op basis van de internetstandaard RFC 822. Volgens de conventie moet dit 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserState

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserStateChangedOn

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserType

Een tekenreekswaarde die kan worden gebruikt om gebruikerstypen in uw directory te classificeren, zoals 'Lid' en 'Gast'.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Notities

Zie de migratiehandleiding voor New-AzureADUser naar Microsoft Graph PowerShell.