Delen via


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;

  1. maak een variabele in PowerShell met het volgende 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 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, JPen 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.