New-AzADUser
Добавление новой сущности пользователям
Синтаксис
New-AzADUser
-DisplayName <String>
-MailNickname <String>
-UserPrincipalName <String>
-Password <SecureString>
[-AboutMe <String>]
[-AccountEnabled <Boolean>]
[-AgeGroup <String>]
[-Birthday <DateTime>]
[-City <String>]
[-CompanyName <String>]
[-ConsentProvidedForMinor <String>]
[-Country <String>]
[-DeletedDateTime <DateTime>]
[-Department <String>]
[-DeviceEnrollmentLimit <Int32>]
[-EmployeeHireDate <DateTime>]
[-EmployeeId <String>]
[-EmployeeType <String>]
[-ExternalUserState <String>]
[-ExternalUserStateChangeDateTime <DateTime>]
[-FaxNumber <String>]
[-GivenName <String>]
[-HireDate <DateTime>]
[-Interest <String[]>]
[-IsResourceAccount]
[-JobTitle <String>]
[-Mail <String>]
[-MobilePhone <String>]
[-MySite <String>]
[-OfficeLocation <String>]
[-ImmutableId <String>]
[-OtherMail <String[]>]
[-PasswordPolicy <String>]
[-PostalCode <String>]
[-PreferredLanguage <String>]
[-PreferredName <String>]
[-Responsibility <String[]>]
[-School <String[]>]
[-ShowInAddressList]
[-Skill <String[]>]
[-State <String>]
[-StreetAddress <String>]
[-Surname <String>]
[-UsageLocation <String>]
[-UserType <String>]
[-ForceChangePasswordNextLogin]
[-DefaultProfile <PSObject>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzADUser
-DisplayName <String>
-MailNickname <String>
-UserPrincipalName <String>
[-AboutMe <String>]
[-AccountEnabled <Boolean>]
[-AgeGroup <String>]
[-Birthday <DateTime>]
[-City <String>]
[-CompanyName <String>]
[-ConsentProvidedForMinor <String>]
[-Country <String>]
[-DeletedDateTime <DateTime>]
[-Department <String>]
[-DeviceEnrollmentLimit <Int32>]
[-EmployeeHireDate <DateTime>]
[-EmployeeId <String>]
[-EmployeeType <String>]
[-ExternalUserState <String>]
[-ExternalUserStateChangeDateTime <DateTime>]
[-FaxNumber <String>]
[-GivenName <String>]
[-HireDate <DateTime>]
[-Interest <String[]>]
[-IsResourceAccount]
[-JobTitle <String>]
[-Mail <String>]
[-MobilePhone <String>]
[-MySite <String>]
[-OfficeLocation <String>]
[-ImmutableId <String>]
[-OtherMail <String[]>]
[-PasswordPolicy <String>]
[-PostalCode <String>]
[-PreferredLanguage <String>]
[-PreferredName <String>]
[-Responsibility <String[]>]
[-School <String[]>]
[-ShowInAddressList]
[-Skill <String[]>]
[-State <String>]
[-StreetAddress <String>]
[-Surname <String>]
[-UsageLocation <String>]
[-UserType <String>]
-PasswordProfile <IMicrosoftGraphPasswordProfile>
[-DefaultProfile <PSObject>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Описание
Добавление новой сущности пользователям
Примеры
Пример 1. Создание пользователя с профилем пароля
$password = "xxxxxxxxxx"
$pp = New-Object -TypeName "Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphPasswordProfile" -Property @{Password=$password}
New-AzADUser -DisplayName $uname -PasswordProfile $pp -AccountEnabled $true -MailNickname $nickname -UserPrincipalName $upnСоздание пользователя с профилем пароля
Пример 2. Создание пользователя с паролем
$password = ConvertTo-SecureString -String "****" -AsPlainText -Force
New-AzADUser -DisplayName $uname -Password $password -AccountEnabled $true -MailNickname $nickname -UserPrincipalName $upnСоздание пользователя с паролем
Параметры
-AboutMe
Поле записи текста свободной формы для пользователя, описывающего себя. Возвращается только в $select.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-AccountEnabled
значение true для включения учетной записи; в противном случае значение false.
| Тип: | Boolean |
| Aliases: | EnableAccount |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-AgeGroup
Задает возрастную группу пользователя. Допустимые значения: null, minor, notAdult и adult. Дополнительные сведения см. в определениях свойств группы юридических возрастов. Поддерживает $filter (eq, ne, NOT и in).
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Birthday
День рождения пользователя. Тип метки времени представляет сведения о дате и времени с использованием формата ISO 8601 и всегда находится в формате UTC. Например, полночь UTC 1 января 2014 г. — 2014-01-01T00:00:00Z, возвращенный только в $select.
| Тип: | DateTime |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-City
Город, в котором находится пользователь. Максимальная длина — 128 символов. Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith).
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-CompanyName
Имя компании, связанной с пользователем. Это свойство может быть полезно для описания компании, из которую поступает внешний пользователь. Максимальная длина имени компании составляет 64 символа. Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith).
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Confirm
Запрашивает подтверждение перед запуском командлета.
| Тип: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ConsentProvidedForMinor
Задает, получено ли согласие для несовершеннолетних. Допустимые значения: null, предоставленные, отклоненные и не запрашиваемые. Дополнительные сведения см. в определениях свойств группы юридических возрастов. Поддерживает $filter (eq, ne, NOT и in).
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Country
Страна или регион, в котором находится пользователь; например, США или Великобритания. Максимальная длина — 128 символов. Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith).
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-DefaultProfile
Учетные данные, учетная запись, клиент и подписка, используемые для взаимодействия с Azure.
| Тип: | PSObject |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-DeletedDateTime
.
| Тип: | DateTime |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Department
Имя отдела, в котором работает пользователь. Максимальная длина — 64 символа. Поддерживает $filter (eq, ne, NOT, ge, le и в операторах).
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-DeviceEnrollmentLimit
Ограничение на максимальное количество устройств, разрешенных пользователю для регистрации. Допустимые значения: 5 или 1000.
| Тип: | Int32 |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-DisplayName
Имя, отображаемое в адресной книге пользователя. Обычно это значение является сочетанием имени пользователя, среднего и последнего имени. Это свойство требуется при создании пользователя и его невозможно очистить во время обновлений. Максимальная длина — 256 символов. Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith), $orderBy и $search.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-EmployeeHireDate
Дата и время, когда пользователь был нанят или начнет работу в случае будущего найма. Поддерживает $filter (eq, ne, NOT, ge, le, in).
| Тип: | DateTime |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-EmployeeId
Идентификатор сотрудника, назначенный пользователю организацией. Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith).
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-EmployeeType
Записывает тип рабочей роли предприятия. Например, "Сотрудник", "Подрядчик", "Консультант" или "Поставщик". Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith).
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ExternalUserState
Для внешнего пользователя, приглашенного к клиенту с помощью API приглашения, это свойство представляет состояние приглашения приглашенного пользователя. Для приглашенных пользователей состояние может быть PendingAcceptance или Accepted или null для всех остальных пользователей. Поддерживает $filter (eq, ne, NOT , in).
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ExternalUserStateChangeDateTime
Отображает метку времени последнего изменения в свойстве externalUserState. Поддерживает $filter (eq, ne, NOT , in).
| Тип: | DateTime |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-FaxNumber
Номер факса пользователя. Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith).
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ForceChangePasswordNextLogin
Он должен быть указан, если пользователь должен изменить пароль для следующего успешного входа (true). По умолчанию используется значение false, чтобы не изменить пароль при следующем успешном входе.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-GivenName
Заданное имя (имя) пользователя. Максимальная длина — 64 символа. Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith).
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-HireDate
Дата найма пользователя. Тип метки времени представляет сведения о дате и времени с использованием формата ISO 8601 и всегда находится в формате UTC. Например, полночь UTC 1 января 2014 г. — 2014-01-01T00:00:00Z. Возвращается только в $select. Примечание. Это свойство зависит от SharePoint Online. Мы рекомендуем использовать собственное свойство employeeHireDate для задания и обновления значений дат найма с помощью API Microsoft Graph.
| Тип: | DateTime |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ImmutableId
Это свойство используется для связывания локальной учетной записи пользователя Active Directory с объектом пользователя Azure AD. Это свойство необходимо указать при создании учетной записи пользователя в Graph, если вы используете федеративный домен для свойства userPrincipalName (UPN). ПРИМЕЧАНИЕ. Символы $ и _ нельзя использовать при указании этого свойства. Возвращается только в $select. Поддерживает $filter (eq, ne, NOT, ge, le, in)..
| Тип: | String |
| Aliases: | OnPremisesImmutableId |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Interest
Список для пользователя, описывающий свои интересы. Возвращается только в $select.
| Тип: | String[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-IsResourceAccount
Не используйте — зарезервировано для будущего использования.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-JobTitle
Название задания пользователя. Максимальная длина — 128 символов. Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith).
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
SMTP-адрес пользователя, например admin@contoso.com. Изменения этого свойства также обновят коллекцию proxyAddresses пользователя, чтобы включить значение в качестве SMTP-адреса. Хотя это свойство может содержать символы акцента, используя их, они могут вызвать проблемы с доступом к другим приложениям Майкрософт для пользователя. Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith, endsWith).
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-MailNickname
Псевдоним почты для пользователя. Это свойство необходимо указать при создании пользователя. Максимальная длина — 64 символа. Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith).
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-MobilePhone
Основной номер мобильного телефона для пользователя. Только для чтения для пользователей, синхронизированных с локального каталога. Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith).
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-MySite
URL-адрес личного сайта пользователя. Возвращается только в $select.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-OfficeLocation
Расположение офиса в месте работы пользователя. Максимальная длина — 128 символов. Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith).
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-OtherMail
Список дополнительных адресов электронной почты для пользователя; например: ['bob@contoso.com', 'Robert@fabrikam.com']. ПРИМЕЧАНИЕ. Хотя это свойство может содержать символы акцента, они могут вызвать проблемы с доступом к сторонним приложениям для пользователя. Поддерживает $filter (eq, NOT, ge, le, in, startsWith).
| Тип: | String[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Password
Пароль для пользователя. Он должен соответствовать требованиям к сложности пароля клиента. Рекомендуется задать надежный пароль.
| Тип: | SecureString |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-PasswordPolicy
Задает политики паролей для пользователя. Это значение представляет собой перечисление с одним из возможных значений DisableStrongPassword, что позволяет задавать более слабые пароли, чем указанная политика по умолчанию. Кроме того, можно указать DisablePasswordExpiration. Они могут быть указаны вместе; например: DisablePasswordExpiration, DisableStrongPassword.Supports $filter (ne, NOT).
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-PasswordProfile
PasswordProfile To create, see NOTES section for PASSWORDPROFILE properties and create a hash table.
| Тип: | IMicrosoftGraphPasswordProfile |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-PostalCode
Почтовый индекс почтового адреса пользователя. Почтовый индекс зависит от страны или региона пользователя. В Соединенных Штатах Америки этот атрибут содержит ZIP-код. Максимальная длина — 40 символов. Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith).
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-PreferredLanguage
Предпочтительный язык для пользователя. Должен соответствовать коду ISO 639-1; например, en-US. Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith).
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-PreferredName
Предпочтительное имя пользователя. Возвращается только в $select.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Responsibility
Список для перечисления обязанностей пользователя. Возвращается только в $select.
| Тип: | String[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-School
Список пользователей для перечисления школ, которые они посещали. Возвращается только в $select.
| Тип: | String[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ShowInAddressList
Значение true, если глобальный список адресов Outlook должен содержать этого пользователя, в противном случае — значение false. Если значение не задано, это будет рассматриваться как true. Для пользователей, приглашенных через диспетчер приглашений, это свойство будет иметь значение false. Поддерживает $filter (eq, ne, NOT, in).
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Skill
Список для пользователя, который будет перечислять свои навыки. Возвращается только в $select.
| Тип: | String[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-State
Штат или провинция в адресе пользователя. Максимальная длина — 128 символов. Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith).
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-StreetAddress
Адрес улицы места работы пользователя. Максимальная длина — 1024 символов. Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith).
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Surname
Фамилия пользователя (фамилия или фамилия). Максимальная длина — 64 символа. Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith).
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-UsageLocation
Код страны с двумя буквами (стандарт ISO 3166). Требуется для пользователей, которым будут назначены лицензии из-за юридических требований для проверки доступности служб в странах. Примеры: US, JP и GB. Не допускается значение NULL. Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith).
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-UserPrincipalName
Имя участника-пользователя (UPN) пользователя. Имя участника-пользователя — это имя для входа в Интернет в стиле Интернета, основанное на стандарте RFC 822. По соглашению это должно соответствовать имени электронной почты пользователя. Общий формат — это alias@domain, где домен должен присутствовать в коллекции проверенных доменов клиента. Это свойство необходимо при создании пользователя. Проверенные домены для клиента можно получить из проверенного свойстваDomains организации. ПРИМЕЧАНИЕ. Хотя это свойство может содержать символы акцента, они могут вызвать проблемы с доступом к сторонним приложениям для пользователя. Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith, endsWith) и $orderBy.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-UserType
Строковое значение, которое можно использовать для классификации типов пользователей в каталоге, таких как Member и Guest. Поддерживает $filter (eq, ne, NOT, in,).
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.
| Тип: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
Выходные данные
Azure PowerShell