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-адрес пользователя, например admin@contoso.com. Изменения этого свойства также обновят коллекцию 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

Список дополнительных адресов электронной почты для пользователя; например: ['bob@contoso.com, 'Robert@fabrikam.com]. ПРИМЕЧАНИЕ. Хотя это свойство может содержать символы акцента, они могут вызвать проблемы с доступом к сторонним приложениям для пользователя. Поддерживает $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. В соответствии с соглашением оно должно указывать на имя пользователя для электронной почты. Общий формат: псевдоним@домен. При этом домен должен входить в коллекцию проверенных доменов клиента. Это свойство обязательно указывать при создании пользователя. Проверенные домены для клиента можно получить из проверенного свойстваDomains организации. ПРИМЕЧАНИЕ. Хотя это свойство может содержать символы акцента, они могут вызвать проблемы с доступом к сторонним приложениям для пользователя. Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith, endsWith) и $orderBy.

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

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

-UserType

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

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

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

-WhatIf

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

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

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

CommonParameters

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

IMicrosoftGraphUser