New-AzureADUser
Создает пользователя Azure AD.
Синтаксис
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>]
Описание
Командлет New-AzureADUser создает пользователя в Azure Active Directory (Azure AD).
Примеры
Пример 1. Создание пользователя
$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
Эта команда создает нового пользователя.
Параметры
-AccountEnabled
Указывает, включена ли учетная запись пользователя.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AgeGroup
Это указывает возрастную группу пользователя.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-City
Указывает город пользователя.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CompanyName
Это указывает название компании пользователя.
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
Указывает страну или регион пользователя.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CreationType
Указывает, является ли учетная запись пользователя локальной учетной записью для клиента Azure Active Directory B2C.
Возможные значения: LocalAccount
и null
.
При создании локальной учетной записи свойство является обязательным, и ему необходимо присвоить значение LocalAccount
.
При создании рабочей или учебной учетной записи не указывайте свойство и не присваивайте ему значение null
.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Department
Указывает отдел пользователя.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisplayName
Указывает отображаемое имя пользователя.
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
Указывает номер телефона пользователя.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GivenName
Указывает имя пользователя.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ImmutableId
Это свойство используется для связи локальной учетной записи пользователя Active Directory с его объектом пользователя в Azure AD. Это свойство должно быть указано при создании новой учетной записи пользователя в Graph, если для свойства пользователя userPrincipalName (UPN) используется федеративный домен.
Важно! Символы $
и _
нельзя использовать при указании этого свойства.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsCompromised
Указывает, скомпрометирован ли этот пользователь.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobTitle
Указывает должность пользователя.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MailNickName
Указывает почтовый псевдоним пользователя.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Mobile
Указывает номер мобильного телефона пользователя.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OtherMails
Список дополнительных адресов электронной почты пользователя. Например, 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
Указывает политики паролей пользователя.
Это значение представляет собой перечисление с одним возможным значением DisableStrongPassword
, которое позволяет указывать более слабые пароли, чем политика по умолчанию.
DisablePasswordExpiration
также можно указать.
Значения можно указывать вместе, например "DisablePasswordExpiration, DisableStrongPassword".
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PasswordProfile
Указывает профиль пароля пользователя.
Обратите внимание, что тип параметра для этого параметра — PasswordProfile
.
Чтобы передать параметр этого типа, сначала необходимо выполнить следующее:
- Создайте переменную в PowerShell с таким типом:
$PasswordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
- Задайте значение пароля в этой переменной:
$PasswordProfile.Password = "\<Password\>"
- Наконец, передайте эту переменную командлету:
New-AzureADUser -PasswordProfile $PasswordProfile ...
Другие атрибуты, которые можно задать в PasswordProfile:
$PasswordProfile.EnforceChangePasswordPolicy
— логическое значение, указывающее, что политика изменения пароля включена или отключена для этого пользователя.$PasswordProfile.ForceChangePasswordNextLogin
— логическое значение, указывающее, что пользователь должен изменить пароль при следующем входе.
Type: | PasswordProfile |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PhysicalDeliveryOfficeName
Указывает имя физического офиса доставки пользователя.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PostalCode
Указывает почтовый индекс пользователя.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PreferredLanguage
Указывает предпочитаемый язык пользователя.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ShowInAddressList
Если задано значение True, отобразите этого пользователя в списке адресов.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SignInNames
Указывает коллекцию имен входа для локальной учетной записи в клиенте Azure Active Directory B2C.
Каждое имя входа должно быть уникальным для всей компании или клиента. Свойство должно быть указано при создании пользователя локальной учетной записи. Не указывайте его при создании рабочей или учебной учетной записи.
Type: | List<T>[Microsoft.Open.AzureAD.Model.SignInName] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-State
Указывает состояние пользователя.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StreetAddress
Указывает почтовый адрес пользователя.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Surname
Указывает фамилию пользователя.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TelephoneNumber
Указывает номер телефона.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UsageLocation
Двухбуквенный код страны или региона (стандарт ISO 3166).
Это необходимо для пользователей, которым будут назначены лицензии в соответствии с юридическими требованиями, чтобы проверка для доступности служб в странах и регионах.
Примеры: US
, JP
и GB
.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserPrincipalName
Указывает имя участника-пользователя( UPN).
UPN — это атрибут, который является именем пользователя для входа через Интернет на основе интернет-стандарта RFC 822.
По соглашению оно должно сопоставляться с адресом электронной почты пользователя.
Общий формат — alias@domain
.
Для рабочих и учебных учетных записей домен должен присутствовать в коллекции подтвержденных доменов клиента. Это свойство является обязательным при создании рабочей или учебной учетной записи и не требуется для локальных учетных записей.
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
Значение строки, которое будет использоваться для классификации типов пользователей в вашем каталоге, например "Member" и "Guest".
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Примечания
См. руководство по миграции New-AzureADUser в Microsoft Graph PowerShell.
Связанные ссылки
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по