Ағылшын тілінде оқу

Бөлісу құралы:

Update-AzADUser

  • Ссылка
Модуль:
Az.Resources

Обновление сущности в пользователях

Синтаксис

PowerShell 
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>]
PowerShell 
Update-AzADUser
      [-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>]
      -ObjectId <String>
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
PowerShell 
Update-AzADUser
      [-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>]
      -InputObject <IMicrosoftGraphUser>
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
PowerShell 
Update-AzADUser
      [-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>]
      -UserPrincipalName <String>
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Описание

Обновление сущности в пользователях

Примеры

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

PowerShell 
Update-AzADUser -UPNOrObjectId $upn -City $city

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

Параметры

-AccountEnabled

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

-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

-DisplayName

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

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера: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

-Id

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

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Identity

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

Тип:IMicrosoftGraphObjectIdentity[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-InputObject

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

Тип:IMicrosoftGraphUser
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки: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

-Mail

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
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ObjectId

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

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-OfficeLocation

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

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-OnPremisesImmutableId

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

Тип: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

-PassThru

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Password

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

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

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

Тип:SecureString
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера: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
Обязательно:False
Принять входные данные конвейера: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

-ShowInAddressList

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

Тип:SwitchParameter
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

-UPNOrObjectId

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

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера: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
Aliases:UPN
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

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

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

Примечания

ПСЕВДОНИМЫ

Set-AzADUser