Поделиться через


Set-AzureADUser

Обновляет пользователя.

Синтаксис

Set-AzureADUser
   -ObjectId <String>
   [-ExtensionProperty <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-AccountEnabled <Boolean>]
   [-AgeGroup <String>]
   [-City <String>]
   [-CompanyName <String>]
   [-ConsentProvidedForMinor <String>]
   [-Country <String>]
   [-CreationType <String>]
   [-Department <String>]
   [-DisplayName <String>]
   [-FacsimileTelephoneNumber <String>]
   [-GivenName <String>]
   [-IsCompromised <Boolean>]
   [-ImmutableId <String>]
   [-JobTitle <String>]
   [-MailNickName <String>]
   [-Mobile <String>]
   [-OtherMails <System.Collections.Generic.List`1[System.String]>]
   [-PasswordPolicies <String>]
   [-PasswordProfile <PasswordProfile>]
   [-PhysicalDeliveryOfficeName <String>]
   [-PostalCode <String>]
   [-PreferredLanguage <String>]
   [-ShowInAddressList <Boolean>]
   [-SignInNames <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.SignInName]>]
   [-State <String>]
   [-StreetAddress <String>]
   [-Surname <String>]
   [-TelephoneNumber <String>]
   [-UsageLocation <String>]
   [-UserPrincipalName <String>]
   [-UserState <String>]
   [-UserStateChangedOn <String>]
   [-UserType <String>]
   [<CommonParameters>]

Описание

Командлет Set-AzureADUser обновляет пользователя в Azure Active Directory (AD).

Примеры

Пример 1. Обновление пользователя

PS C:\> $user = Get-AzureADUser -ObjectId TestUser@example.com 
PS C:\> $user.DisplayName = 'YetAnotherTestUser' 
PS C:\> Set-AzureADUser -ObjectId TestUser@example.com -Displayname $user.Displayname

Пример 2. Установка всех, кроме указанных пользователей, в качестве несовершеннолетних с согласия родителей

Get-AzureADUser -All $true | 
Where-Object -FilterScript { $_.DisplayName -notmatch '(George|James|Education)' } | 
ForEach-Object  { Set-AzureADUser -ObjectId $($_.ObjectId) -AgeGroup 'minor' -ConsentProvidedForMinor 'granted' }

Эта команда обновляет свойство указанного пользователя.

Параметры

-AccountEnabled

Указывает, включено ли правило.

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

-AgeGroup

Используется корпоративными приложениями для определения возрастной группы пользователя по юридическим законам. Это свойство доступно только для чтения и вычисляется на основе свойств ageGroup и consentProvidedForMinor . Допустимые значения: null, notAdultminorи adult. См. [определения свойств юридических возрастных групп][Дополнительные сведения об определениях согласия возрастных групп и несовершеннолетних].

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

-City

Указывает город пользователя.

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

-CompanyName

Название компании, с которой связан пользователь. Это свойство может быть полезно для описания компании, из которую приходит внешний пользователь. Максимальная длина названия компании составляет 64 символа.

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

-ConsentProvidedForMinor

Задает, было ли получено согласие для несовершеннолетних. Допустимые значения: null, deniedgrantedи notRequired. Дополнительные сведения см. в [определениях свойств юридических возрастных групп][Дополнительные сведения об определениях согласия возрастных групп и несовершеннолетних].

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

-Country

Указывает страну или регион пользователя.

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

-CreationType

Указывает, является ли учетная запись пользователя локальной учетной записью для клиента Azure Active Directory B2C. Возможные значения: "LocalAccount" и null. При создании локальной учетной записи свойство является обязательным и должно иметь значение "LocalAccount". При создании рабочей или учебной учетной записи это свойство не указывается или должно иметь значение null.

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

-Department

Указывает отдел пользователя.

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

-DisplayName

Указывает отображаемое имя пользователя.

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

-ExtensionProperty

Добавьте данные в пользовательские свойства в качестве базовых открытых расширений или более универсальных расширений схемы. См. [дополнительные сведения о расширениях][Дополнительные сведения о расширениях].

Тип:Dictionary<TKey,TValue>[System.String,System.String]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-FacsimileTelephoneNumber

Номер факса пользователя.

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

-GivenName

Указывает имя пользователя.

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

-ImmutableId

Это свойство используется для связи локальной учетной записи пользователя Active Directory с его объектом пользователя в Azure AD. Это свойство необходимо указать при создании новой учетной записи пользователя в Graph, если вы используете федеративный домен для свойства пользователя userPrincipalName (UPN). Важно: Символы $ и _ нельзя использовать при указании этого свойства.

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

-IsCompromised

Значение true, если этот пользователь скомпрометирован

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

-JobTitle

Указывает должность пользователя.

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

-MailNickName

Задает псевдоним для почтового адреса пользователя.

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

-Mobile

Указывает номер мобильного телефона пользователя.

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

-ObjectId

Указывает идентификатор пользователя (в виде имени участника-пользователя или ObjectId) в Azure AD.

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

-OtherMails

Указывает другие адреса электронной почты пользователя.

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

-PasswordPolicies

Указывает политики паролей пользователя.

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

-PasswordProfile

Указывает профиль пароля пользователя.

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

-PhysicalDeliveryOfficeName

Расположение офиса в компании пользователя. Максимальная длина — 128 символов.

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

-PostalCode

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

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

-PreferredLanguage

Указывает предпочитаемый язык пользователя.

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

-ShowInAddressList

Установите значение True, чтобы отобразить этого пользователя в списке адресов.

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

-SignInNames

Список имен входа для этого пользователя

Тип:List<T>[Microsoft.Open.AzureAD.Model.SignInName]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-State

Указывает состояние пользователя.

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

-StreetAddress

Указывает почтовый адрес пользователя.

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

-Surname

Указывает фамилию пользователя.

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

-TelephoneNumber

Указывает номер телефона пользователя.

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

-UsageLocation

Двухбуквенный код страны или региона (стандарт ISO 3166). Требуется для пользователей, которым будут назначены лицензии в связи с юридическим требованием проверять доступность служб в странах и регионах. Примеры: "US", "JP" и "GB". Не допускает значения NULL.

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

-UserPrincipalName

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

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

-UserState

Для внешнего пользователя, приглашенного в клиент с помощью API приглашения, это свойство представляет состояние приглашения приглашенного пользователя. Для приглашенных пользователей состоянием может быть PendingAcceptance или Accepted, или null для всех остальных пользователей.

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

-UserStateChangedOn

Показывает метку времени для последнего изменения свойства externalUserState.

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

-UserType

Значение строки, которое будет использоваться для классификации типов пользователей в вашем каталоге, например "Member" и "Guest".

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

Примечания

См. руководство по миграции set-AzureADUser в Microsoft Graph PowerShell.