Командлет 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 принимает одно из следующих значений:
|
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"