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 (Azure AD).

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.

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

-AgeGroup

Detta anger användarens åldersgrupp.

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

-City

Anger användarens stad.

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

-CompanyName

Detta anger användarens företagsnamn.

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

Anger användarens land eller region.

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

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

-Department

Anger användarens avdelning.

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

-DisplayName

Anger användarens visningsnamn.

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

Detta anger användarens telefonnummer.

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

-GivenName

Anger användarens förnamn.

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

-ImmutableId

Den här egenskapen används för att associera ett lokal Active Directory användarkonto till 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.

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

-IsCompromised

Anger om den här användaren har komprometterats.

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

-JobTitle

Anger användarens jobbrubrik.

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

-MailNickName

Anger användarens smeknamn för e-post.

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

-Mobile

Anger användarens mobiltelefonnummer.

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

-OtherMails

En lista över ytterligare e-postadresser för användaren. Till exempel 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

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".

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

-PhysicalDeliveryOfficeName

Anger användarens fysiska leveranskontorsnamn.

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

-PostalCode

Anger användarens postnummer.

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

-PreferredLanguage

Anger användarens föredragna språk.

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

-ShowInAddressList

Om sant visas den här användaren i adresslistan.

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

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

-State

Anger användarens tillstånd.

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

-StreetAddress

Anger användarens gatuadress.

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

-Surname

Anger användarens efternamn.

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

-TelephoneNumber

Anger ett telefonnummer.

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

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

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

Ett strängvärde som kan användas för att klassificera användartyper i din katalog, till exempel "Medlem" och "Gäst".

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

Kommentarer

Se migreringsguiden för New-AzureADUser till Microsoft Graph PowerShell.