New-AzADUser

Синтаксис

WithPassword (по умолчанию)

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>]

WithPasswordProfile

New-AzADUser
    -DisplayName <String>
    -MailNickname <String>
    -UserPrincipalName <String>
    -PasswordProfile <IMicrosoftGraphPasswordProfile>
    [-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>]
    [-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.

Свойства параметра

Наборы параметров

-AccountEnabled

значение true для включения учетной записи; в противном случае значение false.

Свойства параметра

Наборы параметров

-AgeGroup

Устанавливает возрастную группу пользователя. Допустимые значения: null, minor, notAdult и adult. Дополнительные сведения см. в определениях свойств группы юридических возрастов. Поддерживает $filter (eq, ne, NOT и in).

Свойства параметра

Наборы параметров

-Birthday

День рождения пользователя. Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC). Например, полночь UTC 1 января 2014 г. — 2014-01-01T00:00:00Z, возвращенный только в $select.

Свойства параметра

Наборы параметров

-City

Город, в котором находится пользователь. Максимальная длина — 128 символов. Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith).

Свойства параметра

Наборы параметров

-CompanyName

Имя компании, связанной с пользователем. Это свойство может быть полезно для описания компании внешнего пользователя. Максимальная длина имени компании составляет 64 символа. Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith).

Свойства параметра

Наборы параметров

-Confirm

Запрашивает подтверждение перед запуском cmdlet.

Свойства параметра

Наборы параметров

-ConsentProvidedForMinor

Устанавливает, получено ли согласие для несовершеннолетних. Допустимые значения: null, предоставленные, отклоненные и не запрашиваемые. Дополнительные сведения см. в определениях свойств группы юридических возрастов. Поддерживает $filter (eq, ne, NOT и in).

Свойства параметра

Наборы параметров

-Country

Страна или регион, в котором находится пользователь; например, США или Великобритания. Максимальная длина — 128 символов. Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith).

Свойства параметра

Наборы параметров

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для взаимодействия с Azure.

Свойства параметра

Наборы параметров

-DeletedDateTime

.

Свойства параметра

Наборы параметров

-Department

Имя отдела, в котором работает пользователь. Максимальная длина — 64 символа. Поддерживает $filter (eq, ne, NOT, ge, le и в операторах).

Свойства параметра

Наборы параметров

-DeviceEnrollmentLimit

Максимальное количество устройств, которые разрешено зарегистрировать пользователю. Допустимые значения: 5 или 1000.

Свойства параметра

Наборы параметров

-DisplayName

Имя пользователя, отображаемое в адресной книге. Это значение обычно является сочетанием имени, отчества и фамилии пользователя. Это свойство требуется при создании пользователя и его невозможно очистить во время обновлений. Максимальная длина составляет 256 символов. Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith), $orderBy и $search.

Свойства параметра

Наборы параметров

-EmployeeHireDate

Дата и время, когда пользователь был нанят или начнет работу в случае будущего найма. Поддерживает $filter (eq, ne, NOT, ge, le, in).

Свойства параметра

Наборы параметров

-EmployeeId

Идентификатор сотрудника, назначенный пользователю организацией. Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith).

Свойства параметра

Наборы параметров

-EmployeeType

Фиксирует тип корпоративного работника. Например, "Сотрудник", "Подрядчик", "Консультант" или "Поставщик". Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith).

Свойства параметра

Наборы параметров

-ExternalUserState

Для внешнего пользователя, приглашенного к клиенту с помощью API приглашения, это свойство представляет состояние приглашения приглашенного пользователя. Для приглашенных пользователей состояние может быть PendingAcceptance или Accepted или null для всех остальных пользователей. Поддерживает $filter (eq, ne, NOT , in).

Свойства параметра

Наборы параметров

-ExternalUserStateChangeDateTime

Показывает метку времени последнего изменения в свойстве externalUserState. Поддерживает $filter (eq, ne, NOT , in).

Свойства параметра

Наборы параметров

-FaxNumber

Номер факса пользователя. Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith).

Свойства параметра

Наборы параметров

-ForceChangePasswordNextLogin

Он должен быть указан, если пользователь должен изменить пароль для следующего успешного входа (true). По умолчанию используется значение false, чтобы не изменить пароль при следующем успешном входе.

Свойства параметра

Наборы параметров

-GivenName

Простое имя пользователя. Максимальная длина — 64 символа. Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith).

Свойства параметра

Наборы параметров

-HireDate

Дата найма пользователя. Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC). Например, полночь UTC 1 января 2014 г. — 2014-01-01T00:00:00Z. Возвращается только в $select. Примечание. Это свойство зависит от SharePoint Online. Мы рекомендуем использовать собственное свойство employeeHireDate для задания и обновления значений дат найма с помощью API Microsoft Graph.

Свойства параметра

Наборы параметров

-ImmutableId

Это свойство используется для связывания локальной учетной записи пользователя Active Directory с объектом пользователя Azure AD. Это свойство необходимо указать при создании учетной записи пользователя в Graph, если вы используете федеративный домен для свойства userPrincipalName (UPN). ПРИМЕЧАНИЕ. Символы $ и _ нельзя использовать при указании этого свойства. Возвращается только в $select. Поддерживает $filter (eq, ne, NOT, ge, le, in)..

Свойства параметра

Наборы параметров

-Interest

Список интересов пользователя. Возвращается только в $select.

Свойства параметра

Наборы параметров

-IsResourceAccount

Не используйте — зарезервировано для будущего использования.

Свойства параметра

Наборы параметров

-JobTitle

Должность пользователя. Максимальная длина — 128 символов. Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith).

Свойства параметра

Наборы параметров

-Mail

SMTP-адрес пользователя, например [email protected]. Изменения этого свойства также обновят коллекцию proxyAddresses пользователя, чтобы включить значение в качестве SMTP-адреса. Хотя это свойство может содержать символы акцента, используя их, они могут вызвать проблемы с доступом к другим приложениям Майкрософт для пользователя. Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith, endsWith).

Свойства параметра

Наборы параметров

-MailNickname

Почтовый псевдоним для пользователя. Это свойство должно быть указано при создании пользователя. Максимальная длина — 64 символа. Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith).

Свойства параметра

Наборы параметров

-MobilePhone

Основной сотовый телефон пользователя. "Только для чтения" для пользователей, которые синхронизируются с локальным каталогом. Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith).

Свойства параметра

Наборы параметров

-MySite

URL-адрес личного сайта пользователя. Возвращается только в $select.

Свойства параметра

Наборы параметров

-OfficeLocation

Расположение офиса на месте работы пользователя. Максимальная длина — 128 символов. Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith).

Свойства параметра

Наборы параметров

-OtherMail

Список дополнительных адресов электронной почты для пользователя; например: ['[email protected], '[email protected]]. ПРИМЕЧАНИЕ. Хотя это свойство может содержать символы акцента, они могут вызвать проблемы с доступом к сторонним приложениям для пользователя. Поддерживает $filter (eq, NOT, ge, le, in, startsWith).

Свойства параметра

Наборы параметров

-Password

Пароль для пользователя Он должен соответствовать требованиям к сложности пароля клиента. Рекомендуется задать надежный пароль.

Свойства параметра

Наборы параметров

-PasswordPolicy

Задает политики паролей для пользователя. Это значение представляет собой перечисление с одним из возможных значений DisableStrongPassword, что позволяет задавать более слабые пароли, чем указанная политика по умолчанию. Кроме того, можно указать DisablePasswordExpiration. Они могут быть указаны вместе; например: DisablePasswordExpiration, DisableStrongPassword.Supports $filter (ne, NOT).

Свойства параметра

Наборы параметров

-PasswordProfile

PasswordProfile To create, see NOTES section for PASSWORDPROFILE properties and create a hash table.

Свойства параметра

Наборы параметров

-PostalCode

Почтовый индекс адреса пользователя. Формат почтового индекса зависит от страны или региона пользователя. В США для этого атрибута используется ZIP-код. Максимальная длина — 40 символов. Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith).

Свойства параметра

Наборы параметров

-PreferredLanguage

Предпочитаемый язык для пользователя. Должен соответствовать коду ISO 639-1; например, en-US. Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith).

Свойства параметра

Наборы параметров

-PreferredName

Предпочитаемое имя пользователя. Возвращается только в $select.

Свойства параметра

Наборы параметров

-Responsibility

Список обязанностей пользователя. Возвращается только в $select.

Свойства параметра

Наборы параметров

-School

Список учебных заведений, которые посещал пользователь. Возвращается только в $select.

Свойства параметра

Наборы параметров

-ShowInAddressList

Значение true, если глобальный список адресов Outlook должен содержать этого пользователя, в противном случае — значение false. Если значение не задано, это будет рассматриваться как true. Для пользователей, приглашенных через диспетчер приглашений, это свойство будет иметь значение false. Поддерживает $filter (eq, ne, NOT, in).

Свойства параметра

Наборы параметров

-Skill

Список навыков пользователя. Возвращается только в $select.

Свойства параметра

Наборы параметров

-State

Область, республика, край или округ в адресе пользователя. Максимальная длина — 128 символов. Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith).

Свойства параметра

Наборы параметров

-StreetAddress

Почтовый адрес места работы пользователя. Максимальная длина: 1024 символа. Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith).

Свойства параметра

Наборы параметров

-Surname

Фамилия пользователя. Максимальная длина — 64 символа. Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith).

Свойства параметра

Наборы параметров

-UsageLocation

Код страны с двумя буквами (стандарт ISO 3166). Требуется для пользователей, которым будут назначены лицензии из-за юридических требований для проверки доступности служб в странах. Примеры: США, JP и ГБ. Не допускает значения NULL. Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith).

Свойства параметра

Наборы параметров

-UserPrincipalName

Учетное имя (UPN) пользователя. Имя участника-пользователя — это имя для входа в Интернет в стиле Интернета, основанное на стандарте RFC 822. В соответствии с соглашением оно должно указывать на имя пользователя для электронной почты. Общий формат — это alias@domain, где домен должен присутствовать в коллекции проверенных доменов клиента. Это свойство обязательно указывать при создании пользователя. Проверенные домены для клиента можно получить из проверенного свойстваDomains организации. ПРИМЕЧАНИЕ. Хотя это свойство может содержать символы акцента, они могут вызвать проблемы с доступом к сторонним приложениям для пользователя. Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith, endsWith) и $orderBy.

Свойства параметра

Наборы параметров

-UserType

Строковое значение, которое можно использовать для классификации типов пользователей в каталоге, таких как Member и Guest. Поддерживает $filter (eq, ne, NOT, in,).

Свойства параметра

Наборы параметров

-WhatIf

Показывает, что произойдет, если командлет будет запущен. Командлет не запускается.

Свойства параметра

Наборы параметров

CommonParameters

Выходные данные

IMicrosoftGraphUser