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


Set-MsolUser

Изменяет пользователя в Azure Active Directory.

Синтаксис

Set-MsolUser
   [-ImmutableId <String>]
   [-ObjectId <Guid>]
   [-UserPrincipalName <String>]
   [-BlockCredential <Boolean>]
   [-City <String>]
   [-Country <String>]
   [-Department <String>]
   [-DisplayName <String>]
   [-Fax <String>]
   [-FirstName <String>]
   [-LastName <String>]
   [-LastPasswordChangeTimestamp <DateTime>]
   [-MobilePhone <String>]
   [-Office <String>]
   [-PasswordNeverExpires <Boolean>]
   [-PhoneNumber <String>]
   [-PostalCode <String>]
   [-PreferredDataLocation <String>]
   [-PreferredLanguage <String>]
   [-SoftDeletionTimestamp <DateTime>]
   [-State <String>]
   [-StreetAddress <String>]
   [-StrongPasswordRequired <Boolean>]
   [-Title <String>]
   [-UsageLocation <String>]
   [-AlternateEmailAddresses <String[]>]
   [-StrongAuthenticationMethods <StrongAuthenticationMethod[]>]
   [-AlternateMobilePhones <String[]>]
   [-StrongAuthenticationRequirements <StrongAuthenticationRequirement[]>]
   [-StsRefreshTokensValidFrom <DateTime>]
   [-UserType <UserType>]
   [-TenantId <Guid>]
   [<CommonParameters>]

Описание

Командлет Set-MsolUser изменяет объект пользователя.

Используйте этот командлет только для обновлений базовых свойств. Обновите лицензии, пароль и имя субъекта-пользователя для пользователя с помощью командлетов Set-MsolUserLicense, Set-MsolUserPassword и Set-MsolUserPrincipalName .

Примеры

Пример 1. Блокировка учетных данных для пользователя

PS C:\> Set-MsolUser -UserPrincipalName "davidchew@contoso.com" -BlockCredential $True

Эта команда задает параметр блокировать учетные данные для $True для пользователя, что не позволяет ему войти в систему. Это невозможно сделать для синхронизированного пользователя.

Пример 2. Обновление отображаемого имени

PS C:\> Set-MsolUser -UserPrincipalName "davidchew@contoso.com" -DisplayName "David Chew" -Title "Manager" -Department "Finance"

Эта команда обновляет отображаемое имя указанного пользователя.

Пример 3. Установка расположения пользователя

PS C:\> Set-MsolUser -UserPrincipalName "davidchew@contoso.com" -UsageLocation "CA"

Эта команда задает страну или регион расположения пользователя. Страна или регион должны иметь двухбуквенный код ISO. Код можно указать как для синхронизированных пользователей, так и для управляемых.

Пример 4. Установка предпочтительного расположения данных

PS C:\> Set-MsolUser -UserPrincipalName "davidchew@contoso.com" -PreferredDataLocation "EUR"

Эта команда задает предпочтительное свойство расположения данных пользователя, имя участника-пользователя которого равно davidchew@contoso.com EUR.

Параметры

-AlternateEmailAddresses

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

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

-AlternateMobilePhones

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

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

-BlockCredential

Указывает, не может ли пользователь войти в систему с помощью своего идентификатора пользователя.

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

-City

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

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

-Country

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

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

-Department

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

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

-DisplayName

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

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

-Fax

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

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

-FirstName

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

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

-ImmutableId

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

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

-LastName

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

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

-LastPasswordChangeTimestamp

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

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

-MobilePhone

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

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

-ObjectId

Указывает уникальный идентификатор объекта пользователя.

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

-Office

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

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

-PasswordNeverExpires

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

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

-PhoneNumber

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

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

-PostalCode

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

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

-PreferredDataLocation

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

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

-PreferredLanguage

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

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

-SoftDeletionTimestamp

Указывает время обратимого удаления.

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

-State

Указывает штат или провинцию, в которой находится пользователь.

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

-StreetAddress

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

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

-StrongAuthenticationMethods

Задает массив методов строгой проверки подлинности.

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

-StrongAuthenticationRequirements

Задает массив требований строгой проверки подлинности.

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

-StrongPasswordRequired

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

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

-StsRefreshTokensValidFrom

Задает значение StsRefreshTokensValidFrom.

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

-TenantId

Указывает уникальный идентификатор клиента, с которым выполняется операция. Значением по умолчанию является клиент текущего пользователя. Этот параметр применяется только к пользователям-партнерам.

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

-Title

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

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

-UsageLocation

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

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

-UserPrincipalName

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

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

-UserType

Определяет тип пользователя.

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