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


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

 

Применимо к: Exchange Server 2007

Последнее изменение раздела: 2007-06-05

Командлет 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 [-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 изменяет атрибуты существующего пользователя в Active Directory.

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

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

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

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

Параметры

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

Идентификатор

Обязательность

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 используется, чтобы задать краткое имя для пользователя Теда Бремера (Ted Bremer).

Set-User -Identity Contoso\Ted -DisplayName "Ted Bremer"