Dela via


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;

  1. skapa en variabel i PowerShell med den typen:

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

  1. Ange värdet för lösenordet i den här variabeln:

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

  1. 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, JPoch 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.