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