New-MsolUser
Создает пользователя в Azure Active Directory.
Синтаксис
New-MsolUser
[-ImmutableId <String>]
[-UserPrincipalName <String>]
[-BlockCredential <Boolean>]
[-City <String>]
[-Country <String>]
[-Department <String>]
[-DisplayName <String>]
[-Fax <String>]
[-FirstName <String>]
[-LastName <String>]
[-LastPasswordChangeTimestamp <DateTime>]
[-MobilePhone <String>]
[-Office <String>]
[-PasswordNeverExpires <Boolean>]
[-PhoneNumber <String>]
[-PostalCode <String>]
[-PreferredDataLocation <String>]
[-PreferredLanguage <String>]
[-SoftDeletionTimestamp <DateTime>]
[-State <String>]
[-StreetAddress <String>]
[-StrongPasswordRequired <Boolean>]
[-Title <String>]
[-UsageLocation <String>]
[-AlternateEmailAddresses <String[]>]
[-StrongAuthenticationMethods <StrongAuthenticationMethod[]>]
[-AlternateMobilePhones <String[]>]
[-StrongAuthenticationRequirements <StrongAuthenticationRequirement[]>]
[-StsRefreshTokensValidFrom <DateTime>]
[-UserType <UserType>]
[-Password <String>]
[-LicenseOptions <LicenseOption[]>]
[-ForceChangePassword <Boolean>]
[-LicenseAssignment <String[]>]
[-TenantId <Guid>]
[<CommonParameters>] Описание
Командлет New-MsolUser создает пользователя в Azure Active Directory. Чтобы предоставить пользователю доступ к службам, назначьте лицензию с помощью параметра LicenseAssignment .
Примеры
Пример 1. Создание пользователя
PS C:\> New-MsolUser -UserPrincipalName "davidchew@contoso.com" -DisplayName "David Chew" -FirstName "David" -LastName "Chew"Эта команда создает пользователя. У пользователя нет назначенных лицензий. Для пользователя создается случайный пароль.
Пример 2. Создание пользователя и назначение лицензии
Примечание
Параметр -LicenseAssignment не рекомендуется использовать. Узнайте , как назначать лицензии с помощью Microsoft Graph PowerShell. Дополнительные сведения см. в разделе Назначение лицензий API Microsoft Graph.
PS C:\> New-MsolUser -UserPrincipalName "davidchew@contoso.com" -DisplayName "David Chew" -FirstName "David" -LastName "Chew" -UsageLocation "US" -LicenseAssignment "Contoso:BPOS_Standard"Эта команда создает пользователя и назначает лицензию.
Пример 3. Создание пользователя и предпочтительного расположения данных
PS C:\> New-MsolUser -UserPrincipalName "davidchew@contoso.onmicrosoft.com" -DisplayName "David" -PreferredDataLocation "EUR"Эта команда создает пользователя, имя участника-пользователя которого — jdavidchew@contoso.onmicrosoft.com, отображаемое имя — David, а предпочтительное расположение данных — EUR.
Параметры
-AlternateEmailAddresses
Указывает альтернативные адреса электронной почты для пользователя.
| Тип: | String[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-AlternateMobilePhones
Указывает альтернативные номера мобильных телефонов для пользователя.
| Тип: | String[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-BlockCredential
Указывает, не может ли пользователь войти в систему с помощью своего идентификатора пользователя.
| Тип: | Boolean |
| Position: | Named |
| Default value: | $false |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-City
Указывает город пользователя.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Country
Указывает страну или регион пользователя.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Department
Указывает отдел пользователя.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-DisplayName
Указывает отображаемое имя пользователя.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Fax
Указывает номер факса пользователя.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-FirstName
Указывает имя пользователя.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-ForceChangePassword
Указывает, что пользователь должен изменить пароль при следующем входе.
| Тип: | Boolean |
| Position: | Named |
| Default value: | $true |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-ImmutableId
Указывает неизменяемый идентификатор федеративного удостоверения пользователя. Этот параметр следует опустить для пользователей со стандартными удостоверениями.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-LastName
Указывает фамилию пользователя.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-LastPasswordChangeTimestamp
Указывает время последнего изменения пароля.
| Тип: | DateTime |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-LicenseAssignment
Указывает массив лицензий для назначения пользователю.
Примечание
Параметр -LicenseAssignment не рекомендуется использовать. Узнайте , как назначать лицензии с помощью Microsoft Graph PowerShell. Дополнительные сведения см. в разделе Назначение лицензий API Microsoft Graph.
| Тип: | String[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-LicenseOptions
Задает параметры назначения лицензий. Используется для выборочного отключения отдельных планов обслуживания в SKU.
| Тип: | LicenseOption[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-MobilePhone
Указывает номер мобильного телефона пользователя.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Office
Указывает офис пользователя.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Password
Указывает новый пароль для пользователя. Если для пользователя установлено требование надежного пароля, то необходимо соблюсти все указанные ниже правила.
- Пароль должен содержать по крайней мере одну строчную букву.
- Пароль должен содержать по крайней мере одну прописную букву
- Пароль должен содержать по крайней мере один символ, отличный от буквы и цифры.
- Пароль не может содержать пробелы, табуляции или разрывы строк
- Длина пароля должна составлять 8–16 символов.
- Имя пользователя не может содержаться в пароле
Если это значение пропущено, пользователю назначается случайный пароль.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-PasswordNeverExpires
Указывает, периодически ли истекает срок действия пароля пользователя.
| Тип: | Boolean |
| Position: | Named |
| Default value: | $false |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-PhoneNumber
Указывает номер телефона пользователя.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-PostalCode
Указывает почтовый индекс пользователя.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-PreferredDataLocation
Указывает предпочтительное расположение данных для пользователя.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-PreferredLanguage
Указывает предпочитаемый язык пользователя.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-SoftDeletionTimestamp
Указывает время для обратимого удаления.
| Тип: | DateTime |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-State
Указывает область или провинцию, в которой находится пользователь.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-StreetAddress
Указывает почтовый адрес пользователя.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-StrongAuthenticationMethods
Задает массив методов строгой проверки подлинности.
| Тип: | StrongAuthenticationMethod[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-StrongAuthenticationRequirements
Задает массив требований к строгой проверке подлинности.
| Тип: | StrongAuthenticationRequirement[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-StrongPasswordRequired
Указывает, требуется ли надежный пароль для пользователя.
| Тип: | Boolean |
| Position: | Named |
| Default value: | $true |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-StsRefreshTokensValidFrom
Задает значение StsRefreshTokensValidFrom.
| Тип: | DateTime |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-TenantId
Указывает уникальный идентификатор клиента, для которого выполняется операция. Значением по умолчанию является клиент текущего пользователя. Этот параметр применяется только к пользователям партнеров.
| Тип: | Guid |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Title
Указывает название пользователя.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-UsageLocation
Указывает расположение пользователя, в котором используются службы. Укажите двухбуквенный код страны или региона.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-UserPrincipalName
Указывает идентификатор пользователя для этого пользователя. Это обязательный шаг.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-UserType
Определяет тип пользователя.
| Тип: | UserType |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
Выходные данные
Microsoft.Online.Administration.User
Этот командлет возвращает сведения о новом пользователе, который был создан, включая его временный пароль.