Командлет 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 могут быть следующие значения:
|
||
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 действуют ограничения, описанные ниже.
|
||
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 |
Параметр 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" |