Командлет Set-User используется для изменения атрибутов пользователя в службе каталогов Active Directory.

Синтаксис

set-User -Identity <UserIdParameter> [-AllowUMCallsFromNonUsers <None | SearchEnabled>] [-AssistantName <String>] [-City <String>] [-Company <String>] [-Confirm [<SwitchParameter>]] [-CountryOrRegion <CountryInfo>] [-CreateDTMFMap <$true | $false>] [-Department <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-Fax <String>] [-FirstName <String>] [-HomePhone <String>] [-IgnoreDefaultScope <SwitchParameter>] [-Initials <String>] [-LastName <String>] [-Manager <UserContactIdParameter>] [-MobilePhone <String>] [-Name <String>] [-Notes <String>] [-Office <String>] [-OtherFax <MultiValuedProperty>] [-OtherHomePhone <MultiValuedProperty>] [-OtherTelephone <MultiValuedProperty>] [-Pager <String>] [-Phone <String>] [-PhoneticDisplayName <String>] [-PostalCode <String>] [-PostOfficeBox <MultiValuedProperty>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-SimpleDisplayName <String>] [-StateOrProvince <String>] [-StreetAddress <String>] [-TelephoneAssistant <String>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-UserPrincipalName <String>] [-UseRusServer <String>] [-WebPage <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]
set-User [-AllowUMCallsFromNonUsers <None | SearchEnabled>] [-AssistantName <String>] [-City <String>] [-Company <String>] [-Confirm [<SwitchParameter>]] [-CountryOrRegion <CountryInfo>] [-CreateDTMFMap <$true | $false>] [-Department <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-Fax <String>] [-FirstName <String>] [-HomePhone <String>] [-IgnoreDefaultScope <SwitchParameter>] [-Initials <String>] [-Instance <User>] [-LastName <String>] [-Manager <UserContactIdParameter>] [-MobilePhone <String>] [-Name <String>] [-Notes <String>] [-Office <String>] [-OtherFax <MultiValuedProperty>] [-OtherHomePhone <MultiValuedProperty>] [-OtherTelephone <MultiValuedProperty>] [-Pager <String>] [-Phone <String>] [-PhoneticDisplayName <String>] [-PostalCode <String>] [-PostOfficeBox <MultiValuedProperty>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-SimpleDisplayName <String>] [-StateOrProvince <String>] [-StreetAddress <String>] [-TelephoneAssistant <String>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-UserPrincipalName <String>] [-UseRusServer <String>] [-WebPage <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Параметры

Параметр Обязательный Тип Описание

Identity

Обязательный

Microsoft.Exchange.Configuration.Tasks.UserIdParameter

У параметра Identity могут быть следующие значения:

  • идентификатор GUID

  • Различающееся имя (DN)

  • домен\имя_учетной_записи

  • Имя участника-пользователя (UPN)

  • DN Exchange в прежней версии

  • SMTP-адрес;

  • Псевдоним

AllowUMCallsFromNonUsers

Необязательный

Microsoft.Exchange.Data.Directory.Recipient.AllowUMCallsFromNonUsersFlags

Этот параметр определяет, необходимо ли исключать пользователя из поисков в каталоге.

AssistantName

Необязательный

System.String

Параметр AssistantName определяет имя помощника пользователя.

City

Необязательный

System.String

Параметр City определяет город, в котором находится пользователь.

Company

Необязательный

System.String

Параметр Company определяет компанию пользователя.

Confirm

Необязательный

System.Management.Automation.SwitchParameter

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

CountryOrRegion

Необязательный

Microsoft.Exchange.Data.Directory.CountryInfo

Параметр CountryOrRegion определяет страну или регион пользователя.

CreateDTMFMap

Необязательный

System.Boolean

Этот параметр определяет, что для пользователя создается сопоставление DTMF.

Department

Необязательный

System.String

Параметр Department определяет отдел пользователя.

DisplayName

Необязательный

System.String

Параметр DisplayName определяет краткое имя пользователя.

DomainController

Необязательный

Microsoft.Exchange.Data.Fqdn

Чтобы задать полное доменное имя (FQDN) контроллера домена, который записывает эти изменения конфигурации в Active Directory, включите в команду параметр DomainController.

Fax

Необязательный

System.String

Параметр Fax определяет номер факса пользователя.

FirstName

Необязательный

System.String

Параметр FirstName определяет имя пользователя.

HomePhone

Необязательный

System.String

Параметр HomePhone определяет номер домашнего телефона пользователя.

IgnoreDefaultScope

Необязательный

System.Management.Automation.SwitchParameter

Параметр IgnoreDefaultScope указывает, что при выполнении команды параметр, определяющий область получателя по умолчанию для командной консоли Exchange, должен пропускаться, и задает в качестве области весь лес. Это обеспечивает команде доступ к объектам Active Directory, которые в текущий момент не относятся к области по умолчанию. При использовании параметра IgnoreDefaultScope действуют ограничения, описанные ниже.

  • Нельзя использовать параметр DomainController. Команда будет использовать подходящий сервер глобального каталога автоматически.

  • В качестве значения параметра Identity можно использовать только различающееся имя. Другие формы идентификации, например с помощью псевдонима или идентификатора GUID, не допускаются.

Initials

Необязательный

System.String

Параметр Initials определяет инициалы пользователя.

Instance

Необязательный

Microsoft.Exchange.Data.Directory.Management.User

Параметр Instance позволяет передать в обрабатываемую команду весь объект. Он обычно используется в сценариях, где команде необходимо передавать целый объект.

LastName

Необязательный

System.String

Параметр LastName определяет фамилию пользователя.

Manager

Необязательный

Microsoft.Exchange.Configuration.Tasks.UserContactIdParameter

Параметр Manager определяет диспетчера пользователей.

MobilePhone

Необязательный

System.String

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

Name

Необязательный

System.String

Параметр Name определяет обычное имя пользователя.

Notes

Необязательный

System.String

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

Office

Необязательный

System.String

Параметр Office определяет название или номер реального офиса пользователя.

OtherFax

Необязательный

Microsoft.Exchange.Data.MultiValuedProperty

Параметр OtherFax определяет альтернативный номер факса пользователя.

OtherHomePhone

Необязательный

Microsoft.Exchange.Data.MultiValuedProperty

Параметр OtherHomePhone определяет альтернативный номер домашнего телефона пользователя.

OtherTelephone

Необязательный

Microsoft.Exchange.Data.MultiValuedProperty

Параметр OtherTelephone определяет альтернативный номер телефона пользователя.

Pager

Необязательный

System.String

Параметр Pager определяет номер пейджера пользователя.

Phone

Необязательный

System.String

Параметр Phone определяет номер служебного телефона пользователя.

PhoneticDisplayName

Необязательный

System.String

Параметр PhoneticDisplayName определяет произношение параметра DisplayName по звукам.

Максимальная длина этого параметра составляет 255 знаков. Дополнительные сведения о параметре PhoneticDisplayName и распознавании речи см. в разделеПоиск в каталоге автоматического распознавания речи.

PostalCode

Необязательный

System.String

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

PostOfficeBox

Необязательный

Microsoft.Exchange.Data.MultiValuedProperty

Параметр PostOfficeBox определяет номер почтового ящика пользователя.

ResetPasswordOnNextLogon

Необязательный

System.Boolean

Параметр ResetPasswordOnNextLogon указывает, должна ли выполняться смена пароля, указанного в параметре Password, при следующем входе пользователя. По умолчанию установлено значение «$true».

SamAccountName

Необязательный

System.String

Параметр SamAccountName указывает имя для входа, используемое для поддержки клиентов и серверов, работающих под управлением более старых версий операционной системы, например Microsoft Windows NT 4.0, Windows 98, Windows 95 и LAN Manager. Этот атрибут должен содержать менее 20 знаков.

SimpleDisplayName

Необязательный

System.String

Параметр SimpleDisplayName используется для вывода альтернативного описания объекта, если разрешен только ограниченный набор знаков. Этот набор включает следующие символы:

abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789\"()+,-./:?

StateOrProvince

Необязательный

System.String

Параметр StateOrProvince определяет область или край пользователя.

StreetAddress

Необязательный

System.String

Параметр StreetAddress определяет реальный адрес пользователя.

TelephoneAssistant

Необязательный

System.String

Параметр TelephoneAssistant определят телефонный номер помощника для пользователя.

Title

Необязательный

System.String

Параметр Title определяет должность пользователя.

UMDialPlan

Необязательный

Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter

Этот параметр определяет идентификатор объекта каталога для абонентской группы.

UMDtmfMap

Необязательный

Microsoft.Exchange.Data.MultiValuedProperty

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

UserPrincipalName

Необязательный

System.String

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

UseRusServer

Необязательный

System.String

Примечание.
Этот параметр доступен только в Exchange 2007 с пакетом обновления 2 (SP2).

Параметр UseRusServer указывает на необходимость использования определенного сервера почтовых ящиков, на котором выполняется служба списка адресов, для получения и установки атрибутов почтового ящика и пользователя Active Directory.

Служба списка адресов является компонентом службы системного помощника Exchange. С ее помощью создаются и поддерживаются характерные для Exchange значения атрибутов в Active Directory. Служба списка адресов позволяет обновлять объекты получателя в домене с использованием определенных сведений, таких как членство в списке адресов и адреса электронной почты.

WebPage

Необязательный

System.String

Параметр WebPage определяет веб-страницу пользователя.

WhatIf

Необязательный

System.Management.Automation.SwitchParameter

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

WindowsEmailAddress

Необязательный

Microsoft.Exchange.Data.SmtpAddress

Параметр WindowsEmailAddress определяет адрес электронной почты получателя.

Подробное описание

Командлет Set-User изменяет атрибуты существующего пользователя в Active Directory.

Для выполнения командлета Set-User используемой учетной записи необходимо делегировать следующие роли:

  • роль администратора получателей Exchange;

  • роль оператора учета для соответствующих контейнеров Active Directory.

Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.

Типы входных данных

Типы возвращаемых данных

Ошибки

Ошибка Описание

  

 

Исключения

Исключения Описание

  

 

Пример

В следующем примере командлет Set-User используется, чтобы задать краткое имя для пользователя Теда Бремера (Ted Bremer).

Копировать код
Set-User -Identity Contoso\Ted -DisplayName "Ted Bremer"