New-AzureADUser
Skapar en Azure AD-användare.
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
Cmdleten New-AzureADUser skapar en användare i Azure Active Directory (AD Azure).
Exempel
Exempel 1: Skapa en användare
$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
Det här kommandot skapar en ny användare.
Parametrar
-AccountEnabled
Anger om användarens konto är aktiverat.
Typ: | Boolean |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | True |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-AgeGroup
Detta anger användarens åldersgrupp.
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-City
Anger användarens stad.
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-CompanyName
Detta anger användarens företagsnamn.
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-ConsentProvidedForMinor
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-Country
Anger användarens land eller region.
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-CreationType
Anger om användarkontot är ett lokalt konto för en Azure Active Directory B2C-klientorganisation.
Möjliga värden är LocalAccount
och null
.
När du skapar ett lokalt konto krävs egenskapen och du måste ange den till LocalAccount
.
När du skapar ett arbets- eller skolkonto ska du inte ange egenskapen eller ange den till null
.
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-Department
Anger användarens avdelning.
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-DisplayName
Anger användarens visningsnamn.
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | True |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-ExtensionProperty
Typ: | Dictionary<TKey,TValue>[System.String,System.String] |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-FacsimileTelephoneNumber
Detta anger användarens telefonnummer.
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-GivenName
Anger användarens förnamn.
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-ImmutableId
Den här egenskapen används för att associera ett lokalt Active Directory-användarkonto med deras Azure AD-användarobjekt. Den här egenskapen måste anges när du skapar ett nytt användarkonto i Graph om du använder en federerad domän för användarens UPN-egenskap (userPrincipalName).
Viktigt: Tecknen $
och _
kan inte användas när du anger den här egenskapen.
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-IsCompromised
Anger om den här användaren har komprometterats.
Typ: | Boolean |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-JobTitle
Anger användarens jobbrubrik.
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-MailNickName
Anger användarens smeknamn för e-post.
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-Mobile
Anger användarens mobiltelefonnummer.
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-OtherMails
En lista över ytterligare e-postadresser för användaren. Till exempel bob@contoso.com
, Robert@fabrikam.com
.
Typ: | List<T>[String] |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-PasswordPolicies
Anger lösenordsprinciper för användaren.
Det här värdet är en uppräkning där ett möjligt värde är DisableStrongPassword
, vilket gör att svagare lösenord än standardprincipen kan anges.
DisablePasswordExpiration
kan också anges.
De två kan anges tillsammans. till exempel: "DisablePasswordExpiration, DisableStrongPassword".
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-PasswordProfile
Anger användarens lösenordsprofil.
Observera att parametertypen för den här parametern är PasswordProfile
.
För att kunna skicka en parameter av den här typen måste du först;
- skapa en variabel i PowerShell med den typen:
$PasswordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
- Ange värdet för lösenordet i den här variabeln:
$PasswordProfile.Password = "\<Password\>"
- Skicka slutligen den här variabeln till cmdleten:
New-AzureADUser -PasswordProfile $PasswordProfile ...
Andra attribut som kan anges i PasswordProfile är:
-
$PasswordProfile.EnforceChangePasswordPolicy
– ett booleskt värde som anger att principen för ändringslösenord är aktiverad eller inaktiverad för den här användaren. -
$PasswordProfile.ForceChangePasswordNextLogin
– ett booleskt värde som anger att användaren måste ändra lösenordet vid nästa inloggning.
Typ: | PasswordProfile |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | True |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-PhysicalDeliveryOfficeName
Anger användarens fysiska leveranskontorsnamn.
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-PostalCode
Anger användarens postnummer.
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-PreferredLanguage
Anger användarens föredragna språk.
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-ShowInAddressList
Om sant visas den här användaren i adresslistan.
Typ: | Boolean |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-SignInNames
Anger samlingen med inloggningsnamn för ett lokalt konto i en Azure Active Directory B2C-klientorganisation.
Varje inloggningsnamn måste vara unikt i hela företaget/klientorganisationen. Egenskapen måste anges när du skapar en lokal kontoanvändare. Ange det inte när du skapar ett arbets- eller skolkonto.
Typ: | List<T>[Microsoft.Open.AzureAD.Model.SignInName] |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-State
Anger användarens tillstånd.
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-StreetAddress
Anger användarens gatuadress.
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-Surname
Anger användarens efternamn.
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-TelephoneNumber
Anger ett telefonnummer.
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-UsageLocation
En lands- eller regionkod med två bokstäver (ISO-standard 3166).
Det krävs för användare som ska tilldelas licenser på grund av juridiska krav för att söka efter tillgänglighet för tjänster i länder och regioner.
Exempel är: US
, JP
och GB
.
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-UserPrincipalName
Anger användarens huvudnamn (UPN).
UPN är ett inloggningsnamn i Internetstil för användaren baserat på Internetstandarden RFC 822.
Enligt konventionen bör detta mappas till användarens e-postnamn.
Det allmänna formatet är alias@domain
.
För arbets- eller skolkonton måste domänen finnas i klientorganisationens samling av verifierade domäner. Den här egenskapen krävs när ett arbets- eller skolkonto skapas. det är valfritt för lokala konton.
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-UserState
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-UserStateChangedOn
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-UserType
Ett strängvärde som kan användas för att klassificera användartyper i din katalog, till exempel "Medlem" och "Gäst".
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
Kommentarer
Se migreringsguiden för New-AzureADUser till Microsoft Graph PowerShell.