New-AzureADUser

Vytvoří uživatele Azure AD.

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

Rutina New-AzureADUser vytvoří uživatele v Azure Active Directory (Azure AD).

Příklady

Příklad 1: Vytvoření uživatele

$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

Tento příkaz vytvoří nového uživatele.

Parametry

-AccountEnabled

Určuje, jestli je povolený účet uživatele.

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

-AgeGroup

Určuje věkovou skupinu uživatele.

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

-City

Určuje město uživatele.

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

-CompanyName

Určuje název společnosti uživatele.

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

Určuje zemi nebo oblast uživatele.

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

-CreationType

Určuje, jestli je uživatelský účet místním účtem pro tenanta Azure Active Directory B2C.

Možné hodnoty jsou LocalAccount a null. Při vytváření místního účtu je vlastnost povinná a musíte ji nastavit na LocalAccount. Při vytváření pracovního nebo školního účtu nezadávejte vlastnost ani ji nenastavujte na null.

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

-Department

Určuje oddělení uživatele.

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

-DisplayName

Určuje zobrazované jméno uživatele.

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

Určuje telefonní číslo uživatele.

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

-GivenName

Určuje křestní jméno uživatele.

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

-ImmutableId

Tato vlastnost slouží k přidružení uživatelského účtu místní Active Directory k objektu uživatele Azure AD. Tato vlastnost musí být zadána při vytváření nového uživatelského účtu v Graphu, pokud používáte federovanou doménu pro vlastnost userPrincipalName (UPN) uživatele.

Důležité: Při $ zadávání této vlastnosti nelze použít znaky a _ .

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

-IsCompromised

Určuje, jestli je tento uživatel ohrožen.

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

-JobTitle

Určuje pracovní pozici uživatele.

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

-MailNickName

Určuje e-mailovou přezdívku uživatele.

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

-Mobile

Určuje číslo mobilního telefonu uživatele.

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

-OtherMails

Seznam dalších e-mailových adres pro uživatele Například 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

Určuje zásady hesel pro uživatele.

Tato hodnota je výčet s jednou možnou hodnotou DisableStrongPassword, která umožňuje zadat slabší hesla než výchozí zásady. DisablePasswordExpiration lze také zadat. Mohou být uvedeny společně; Příklad: "DisablePasswordExpiration, DisableStrongPassword".

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

-PasswordProfile

Určuje profil hesla uživatele. Všimněte si, že typ parametru pro tento parametr je PasswordProfile. Chcete-li předat parametr tohoto typu, musíte nejprve;

  1. vytvořte v PowerShellu proměnnou s tímto typem:

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

  1. Nastavte hodnotu hesla v této proměnné:

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

  1. Nakonec předejte rutině tuto proměnnou:

New-AzureADUser -PasswordProfile $PasswordProfile ...

Další atributy, které je možné nastavit v souboru PasswordProfile, jsou:

  • $PasswordProfile.EnforceChangePasswordPolicy – logická hodnota označující, že je pro tohoto uživatele povolená nebo zakázaná zásada pro změnu hesla.
  • $PasswordProfile.ForceChangePasswordNextLogin – logická hodnota označující, že uživatel musí změnit heslo při dalším přihlášení.
Type:PasswordProfile
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PhysicalDeliveryOfficeName

Určuje název fyzické doručovací kanceláře uživatele.

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

-PostalCode

Určuje PSČ uživatele.

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

-PreferredLanguage

Určuje upřednostňovaný jazyk uživatele.

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

-ShowInAddressList

Pokud je pravda, zobrazte tohoto uživatele v seznamu adres.

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

-SignInNames

Určuje kolekci přihlašovacích jmen pro místní účet v tenantovi Azure Active Directory B2C.

Každé přihlašovací jméno musí být jedinečné v rámci společnosti nebo tenanta. Vlastnost musí být zadána při vytváření uživatele místního účtu. Nezadávejte ji při vytváření pracovního nebo školního účtu.

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

-State

Určuje stav uživatele.

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

-StreetAddress

Určuje adresu uživatele.

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

-Surname

Určuje příjmení uživatele.

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

-TelephoneNumber

Určuje telefonní číslo.

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

-UsageLocation

Dvoumísmenný kód země nebo oblasti (standard ISO 3166).

Uživatelé, kterým budou přiřazeny licence kvůli zákonným požadavkům, musí zkontrolovat dostupnost služeb v zemích a oblastech. Příklady: US, JPa GB.

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

-UserPrincipalName

Určuje hlavní název uživatele (UPN).

Hlavní název uživatele (UPN) je internetové přihlašovací jméno uživatele na základě standardu RFC 822 internetu. Podle konvence by se to mělo mapovat na e-mailové jméno uživatele. Obecný formát je alias@domain.

U pracovních nebo školních účtů musí být doména v kolekci ověřených domén tenanta. Tato vlastnost je vyžadována při vytvoření pracovního nebo školního účtu; pro místní účty je nepovinný.

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

Řetězcová hodnota, která se dá použít ke klasifikaci typů uživatelů v adresáři, například "Member" a "Guest".

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

Poznámky

Projděte si průvodce migrací pro New-AzureADUser do Microsoft Graph PowerShellu.