Update-AzADUser

Синтаксис

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

Update-AzADUser
    -UPNOrObjectId <String>
    [-AccountEnabled <Boolean>]
    [-Password <SecureString>]
    [-ForceChangePasswordNextLogin]
    [-AgeGroup <String>]
    [-City <String>]
    [-CompanyName <String>]
    [-ConsentProvidedForMinor <String>]
    [-Country <String>]
    [-DeletedDateTime <DateTime>]
    [-Department <String>]
    [-DisplayName <String>]
    [-EmployeeHireDate <DateTime>]
    [-EmployeeId <String>]
    [-EmployeeType <String>]
    [-ExternalUserState <String>]
    [-ExternalUserStateChangeDateTime <DateTime>]
    [-FaxNumber <String>]
    [-GivenName <String>]
    [-Id <String>]
    [-Identity <IMicrosoftGraphObjectIdentity[]>]
    [-IsResourceAccount]
    [-JobTitle <String>]
    [-Mail <String>]
    [-MailNickname <String>]
    [-OfficeLocation <String>]
    [-OnPremisesImmutableId <String>]
    [-OtherMail <String[]>]
    [-PasswordPolicy <String>]
    [-PasswordProfile <IMicrosoftGraphPasswordProfile>]
    [-PostalCode <String>]
    [-PreferredLanguage <String>]
    [-ShowInAddressList]
    [-State <String>]
    [-StreetAddress <String>]
    [-Surname <String>]
    [-UsageLocation <String>]
    [-UserType <String>]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ObjectIdParameterSet

Update-AzADUser
    -ObjectId <String>
    [-AccountEnabled <Boolean>]
    [-Password <SecureString>]
    [-ForceChangePasswordNextLogin]
    [-AgeGroup <String>]
    [-City <String>]
    [-CompanyName <String>]
    [-ConsentProvidedForMinor <String>]
    [-Country <String>]
    [-DeletedDateTime <DateTime>]
    [-Department <String>]
    [-DisplayName <String>]
    [-EmployeeHireDate <DateTime>]
    [-EmployeeId <String>]
    [-EmployeeType <String>]
    [-ExternalUserState <String>]
    [-ExternalUserStateChangeDateTime <DateTime>]
    [-FaxNumber <String>]
    [-GivenName <String>]
    [-Id <String>]
    [-Identity <IMicrosoftGraphObjectIdentity[]>]
    [-IsResourceAccount]
    [-JobTitle <String>]
    [-Mail <String>]
    [-MailNickname <String>]
    [-OfficeLocation <String>]
    [-OnPremisesImmutableId <String>]
    [-OtherMail <String[]>]
    [-PasswordPolicy <String>]
    [-PasswordProfile <IMicrosoftGraphPasswordProfile>]
    [-PostalCode <String>]
    [-PreferredLanguage <String>]
    [-ShowInAddressList]
    [-State <String>]
    [-StreetAddress <String>]
    [-Surname <String>]
    [-UsageLocation <String>]
    [-UserType <String>]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObjectParameterSet

Update-AzADUser
    -InputObject <IMicrosoftGraphUser>
    [-AccountEnabled <Boolean>]
    [-Password <SecureString>]
    [-ForceChangePasswordNextLogin]
    [-AgeGroup <String>]
    [-City <String>]
    [-CompanyName <String>]
    [-ConsentProvidedForMinor <String>]
    [-Country <String>]
    [-DeletedDateTime <DateTime>]
    [-Department <String>]
    [-DisplayName <String>]
    [-EmployeeHireDate <DateTime>]
    [-EmployeeId <String>]
    [-EmployeeType <String>]
    [-ExternalUserState <String>]
    [-ExternalUserStateChangeDateTime <DateTime>]
    [-FaxNumber <String>]
    [-GivenName <String>]
    [-Id <String>]
    [-Identity <IMicrosoftGraphObjectIdentity[]>]
    [-IsResourceAccount]
    [-JobTitle <String>]
    [-Mail <String>]
    [-MailNickname <String>]
    [-OfficeLocation <String>]
    [-OnPremisesImmutableId <String>]
    [-OtherMail <String[]>]
    [-PasswordPolicy <String>]
    [-PasswordProfile <IMicrosoftGraphPasswordProfile>]
    [-PostalCode <String>]
    [-PreferredLanguage <String>]
    [-ShowInAddressList]
    [-State <String>]
    [-StreetAddress <String>]
    [-Surname <String>]
    [-UsageLocation <String>]
    [-UserType <String>]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UPNParameterSet

Update-AzADUser
    -UserPrincipalName <String>
    [-AccountEnabled <Boolean>]
    [-Password <SecureString>]
    [-ForceChangePasswordNextLogin]
    [-AgeGroup <String>]
    [-City <String>]
    [-CompanyName <String>]
    [-ConsentProvidedForMinor <String>]
    [-Country <String>]
    [-DeletedDateTime <DateTime>]
    [-Department <String>]
    [-DisplayName <String>]
    [-EmployeeHireDate <DateTime>]
    [-EmployeeId <String>]
    [-EmployeeType <String>]
    [-ExternalUserState <String>]
    [-ExternalUserStateChangeDateTime <DateTime>]
    [-FaxNumber <String>]
    [-GivenName <String>]
    [-Id <String>]
    [-Identity <IMicrosoftGraphObjectIdentity[]>]
    [-IsResourceAccount]
    [-JobTitle <String>]
    [-Mail <String>]
    [-MailNickname <String>]
    [-OfficeLocation <String>]
    [-OnPremisesImmutableId <String>]
    [-OtherMail <String[]>]
    [-PasswordPolicy <String>]
    [-PasswordProfile <IMicrosoftGraphPasswordProfile>]
    [-PostalCode <String>]
    [-PreferredLanguage <String>]
    [-ShowInAddressList]
    [-State <String>]
    [-StreetAddress <String>]
    [-Surname <String>]
    [-UsageLocation <String>]
    [-UserType <String>]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Описание

Примеры

Пример 1. Обновление пользователя по имени участника-пользователя

Update-AzADUser -UPNOrObjectId $upn -City $city

Параметры

-AccountEnabled

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

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

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

-AgeGroup

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

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

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

-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 и в операторах).

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

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

-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).

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

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

-Id

Только для чтения.

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

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

-Identity

Представляет удостоверения, которые можно использовать для входа в учетную запись пользователя. Удостоверение может быть предоставлено корпорацией Майкрософт (также известной как локальная учетная запись), организациями или поставщиками социальных удостоверений, такими как Facebook, Google и Майкрософт, и привязано к учетной записи пользователя. Может содержать несколько элементов с одинаковым значением signInType. Поддерживает $filter (eq), только если signInType не является userPrincipalName. Сведения о создании см. в разделе NOTES для свойств IDENTITY и создании хэш-таблицы.

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

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

-InputObject

объект ввода пользователя

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

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

-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).

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

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

-ObjectId

Имя субъекта-пользователя для обновления.

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

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

-OfficeLocation

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

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

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

-OnPremisesImmutableId

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

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

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

-OtherMail

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

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

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

-PassThru

Возвращает значение true, когда команда завершается успешно

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

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

-Password

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

Его можно обновить, но пользователю потребуется изменить пароль для следующего имени входа.

Пароль должен соответствовать минимальным требованиям, указанным свойством passwordPolicies пользователя. По умолчанию требуется надежный пароль. При изменении пароля с помощью этого метода AccountEnabled установлено значение true.

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

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

-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).

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

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

-ShowInAddressList

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

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

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

-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).

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

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

-UPNOrObjectId

Имя субъекта-пользователя или идентификатор объекта пользователя, который требуется обновить.

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

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

-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

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

Boolean

Примечания