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

Синтаксис


set-User -Identity <UserIdParameter> [-AssistantName <String>] [-City <String>] [-Company <String>] [-CountryOrRegion <CountryInfo>] [-CreateDTMFMap <$true \| $false>] [-Department <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-Fax <String>] [-FirstName <String>] [-HomePhone <String>] [-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>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-UserPrincipalName <String>] [-WebPage <String>] [-WindowsEmailAddress <SmtpAddress>]

set-User -Identity <UserIdParameter> [-AssistantName <String>] [-City <String>] [-Company <String>] [-CountryOrRegion <CountryInfo>] [-CreateDTMFMap <$true | $false>] [-Department <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-Fax <String>] [-FirstName <String>] [-HomePhone <String>] [-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>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-UserPrincipalName <String>] [-WebPage <String>] [-WindowsEmailAddress <SmtpAddress>]


set-User [-AssistantName <String>] [-City <String>] [-Company <String>] [-CountryOrRegion <CountryInfo>] [-CreateDTMFMap <$true \| $false>] [-Department <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-Fax <String>] [-FirstName <String>] [-HomePhone <String>] [-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>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-UserPrincipalName <String>] [-WebPage <String>] [-WindowsEmailAddress <SmtpAddress>]

set-User [-AssistantName <String>] [-City <String>] [-Company <String>] [-CountryOrRegion <CountryInfo>] [-CreateDTMFMap <$true | $false>] [-Department <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-Fax <String>] [-FirstName <String>] [-HomePhone <String>] [-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>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-UserPrincipalName <String>] [-WebPage <String>] [-WindowsEmailAddress <SmtpAddress>]

Параметры

Параметр	Обязательность	Тип	Описание
Идентификатор	Обязательность	Microsoft.Exchange.Configuration.Tasks.UserIdParameter	Параметр Identity принимает одно из следующих значений: GUID; Различающееся имя (DN) Domain\Account Имя участника-пользователя Различающееся имя в прежнем формате Exchange SMTP-адрес псевдоним.
AssistantName	Дополнительно	System.String	Параметр AssistantName определяет имя помощника пользователя.
Город	Дополнительно	System.String	Параметр City определяет город, в котором находится пользователь.
Организация	Дополнительно	System.String	Параметр Company определяет компанию пользователя.
CountryOrRegion	Дополнительно	Microsoft.Exchange.Data.Directory.CountryInfo	Параметр CountryOrRegion определяет страну или регион пользователя.
CreateDTMFMap	Дополнительно	System.Boolean	Этот параметр определяет, что для пользователя создается сопоставление DTMF.
Отдел	Дополнительно	System.String	Параметр Department определяет отдел пользователя.
DisplayName	Дополнительно	System.String	Параметр DisplayName определяет краткое имя пользователя.
DomainController	Дополнительно	Microsoft.Exchange.Data.Fqdn	Чтобы указать полное доменное имя (FQDN) контроллера домена, записывающего это изменение конфигурации в Active Directory, включите в команду параметр DomainController.
Факс	Дополнительно	System.String	Параметр Fax определяет номер факса пользователя.
FirstName	Дополнительно	System.String	Параметр FirstName определяет имя пользователя.
HomePhone	Дополнительно	System.String	Параметр HomePhone определяет номер домашнего телефона пользователя.
Initials	Дополнительно	System.String	Параметр Initials определяет инициалы пользователя.
Instance	Дополнительно	Microsoft.Exchange.Data.Directory.Management.User	Параметр Instance позволяет передавать весь объект в команду для обработки. Главным образом он используется в сценариях, в которых в команду должен быть передан весь объект.
LastName	Дополнительно	System.String	Параметр LastName определяет фамилию пользователя.
Диспетчер	Дополнительно	Microsoft.Exchange.Configuration.Tasks.UserContactIdParameter	Параметр Manager определяет диспетчера пользователей.
MobilePhone	Дополнительно	System.String	Параметр MobilePhone определяет основной номер мобильного телефона пользователя.
Имя	Дополнительно	System.String	Параметр Name определяет обычное имя пользователя.
Notes	Дополнительно	System.String	Параметр Notes указывает дополнительные сведения о пользователе.
Комната	Дополнительно	System.String	Параметр Office определяет название или номер реального офиса пользователя.
OtherFax	Дополнительно	Microsoft.Exchange.Data.MultiValuedProperty	Параметр OtherFax определяет альтернативный номер факса пользователя.
OtherHomePhone	Дополнительно	Microsoft.Exchange.Data.MultiValuedProperty	Параметр OtherHomePhone определяет альтернативный номер домашнего телефона пользователя.
OtherTelephone	Дополнительно	Microsoft.Exchange.Data.MultiValuedProperty	Параметр OtherTelephone определяет альтернативный номер телефона пользователя.
Пейджер	Дополнительно	System.String	Параметр Pager определяет номер пейджера пользователя.
Телефон	Дополнительно	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 используется для вывода альтернативного описания объекта, если разрешен только ограниченный набор знаков. Этот ограниченный набор знаков включает набор знаков ASCII от 26 до 126 включительно.
StateOrProvince	Дополнительно	System.String	Параметр StateOrProvince определяет область или край пользователя.
StreetAddress	Дополнительно	System.String	Параметр StreetAddress определяет реальный адрес пользователя.
Название	Дополнительно	System.String	Параметр Title определяет должность пользователя.
UMDialPlan	Дополнительно	Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter	Этот параметр определяет идентификатор объекта каталога для абонентской группы.
UMDtmfMap	Дополнительно	Microsoft.Exchange.Data.MultiValuedProperty	Этот параметр определяет, будет ли создано пользовательское сопоставление DTMF для пользователя единой системы обмена сообщениями.
UserPrincipalName	Дополнительно	System.String	Параметр UserPrincipalName указывает имя участника-пользователя для пользователя.
WebPage	Дополнительно	System.String	Параметр WebPage определяет веб-страницу пользователя.
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"

Exchange 2007

Командлет Set-User (окончательная первоначальная версия)
	Пример