Применимо к: Exchange Server 2010 SP1

Последнее изменение раздела: 2011-04-24

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

Синтаксис

Set-User -Identity <UserIdParameter> [-AllowUMCallsFromNonUsers <None | SearchEnabled>] [-Arbitration <SwitchParameter>] [-AssistantName <String>] [-CertificateSubject <MultiValuedProperty>] [-City <String>] [-Company <String>] [-Confirm [<SwitchParameter>]] [-CountryOrRegion <CountryInfo>] [-CreateDTMFMap <$true | $false>] [-Department <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-EnableAccount <SwitchParameter>] [-Fax <String>] [-FirstName <String>] [-HomePhone <String>] [-IgnoreDefaultScope <SwitchParameter>] [-Initials <String>] [-LastName <String>] [-LinkedCredential <PSCredential>] [-LinkedDomainController <String>] [-LinkedMasterAccount <UserIdParameter>] [-Manager <UserContactIdParameter>] [-MobilePhone <String>] [-Name <String>] [-NetID <NetID>] [-Notes <String>] [-Office <String>] [-OtherFax <MultiValuedProperty>] [-OtherHomePhone <MultiValuedProperty>] [-OtherTelephone <MultiValuedProperty>] [-Pager <String>] [-Phone <String>] [-PhoneticDisplayName <String>] [-PostalCode <String>] [-PostOfficeBox <MultiValuedProperty>] [-RemotePowerShellEnabled <$true | $false>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-SeniorityIndex <Int32>] [-SimpleDisplayName <String>] [-StateOrProvince <String>] [-StreetAddress <String>] [-TelephoneAssistant <String>] [-Title <String>] [-UMCallingLineIds <MultiValuedProperty>] [-UMDtmfMap <MultiValuedProperty>] [-UserPrincipalName <String>] [-WebPage <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>] [-WindowsLiveID <SmtpAddress>]

Параметры

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

Identity

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

Microsoft.Exchange.Configuration.Tasks.UserIdParameter

Параметр Identity задает идентификатор пользователя. Можно использовать одно из следующих значений:

  • GUID

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

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

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

  • различающееся имя в прежнем формате Exchange

  • SMTP-адрес

  • Псевдоним

AllowUMCallsFromNonUsers

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

Microsoft.Exchange.Data.Directory.Recipient.AllowUMCallsFromNonUsersFlags

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

Arbitration

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

System.Management.Automation.SwitchParameter

Параметр Arbitration указывает на то, что почтовый ящик, для которого выполняется команда, является арбитражным. Арбитражные почтовые ящики используются для управления рабочим процессом утверждения. Например, арбитражные почтовые ящики используются для обработки управляемых получателей и утверждения членства в группе рассылки.

AssistantName

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

System.String

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

CertificateSubject

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

Microsoft.Exchange.Data.MultiValuedProperty

Параметр CertificateSubject указывает значение поля субъекта цифрового сертификата пользователя.

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

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

Department

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

System.String

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

DisplayName

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

System.String

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

DomainController

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

Microsoft.Exchange.Data.Fqdn

Параметр DomainController указывает имя FQDN контроллера домена, который записывает это изменение конфигурации в Служба каталогов Active Directory.

EnableAccount

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

System.Management.Automation.SwitchParameter

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

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 указывает инициалы пользователя.

LastName

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

System.String

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

LinkedCredential

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

System.Management.Automation.PSCredential

Параметр LinkedCredential указывает учетные данные для доступа к контроллеру домена, заданному параметром LinkedDomainController.

Параметр LinkedCredential можно использовать только со связанным пользователем.

Для этого параметра требуется создание и передача объекта учетных данных. Этот объект учетных данных создается с помощью командлета Get-Credential. Дополнительные сведения см. в разделе Get-Credential.

LinkedDomainController

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

System.String

Если данный пользователь является связанным, параметр LinkedDomainController указывает контроллер домена в лесу, где находится учетная запись пользователя. Контроллер домена в лесу, где находится учетная запись пользователя, используется для получения сведений безопасности для учетной записи, заданной параметром LinkedMasterAccount.

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

LinkedMasterAccount

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

Microsoft.Exchange.Configuration.Tasks.UserIdParameter

Если данный пользователь является связанным, параметр LinkedMasterAccount указывает главную учетную запись в лесу, где находится учетная запись пользователя. Главная учетная запись является учетной записью, с которой связан пользователь. Главная учетная запись предоставляет доступ к пользователю. Можно использовать одно из следующих значений:

  • GUID

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

  • Домен\Учетная запись

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

  • LegacyExchangeDN

  • SmtpAddress

  • Псевдоним

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

Manager

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

Microsoft.Exchange.Configuration.Tasks.UserContactIdParameter

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

MobilePhone

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

System.String

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

Name

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

System.String

Параметр Name указывает общее имя пользователя.

NetID

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

Microsoft.Exchange.Data.NetID

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

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

RemotePowerShellEnabled

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

System.Boolean

Параметр RemotePowerShellEnabled указывает, можно ли удаленно использовать PowerShell. Удаленная среда Remote PowerShell необходима для открытия командной консоли Exchange или консоли управления Exchange на сервере почтовых ящиков, транспортном сервере-концентраторе, сервере единой системы обмена сообщениями и сервере клиентского доступа. Удаленный доступ к PowerShell необходим даже при открытии консоли на локальном сервере.

Допустимые значения ввода — $True и $False. Значение по умолчанию зависит от групп ролей управления, назначенных пользователю. Дополнительные сведения см. в разделе Обзор командной консоли Exchange.

ResetPasswordOnNextLogon

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

System.Boolean

Параметр ResetPasswordOnNextLogon указывает, должен ли выполняться сброс пароля при следующем входе пользователя. Два возможных значения для этого параметра: $true или $false. Значение по умолчанию: $true.

SamAccountName

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

System.String

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

SeniorityIndex

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

System.Int32

Параметр SeniorityIndex указывает порядок отображения пользователя в иерархической адресной книге. Пользователь со значением 2 будет отображаться в адресной книге выше, чем пользователь со значением 1.

SimpleDisplayName

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

System.String

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

StateOrProvince

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

System.String

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

StreetAddress

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

System.String

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

TelephoneAssistant

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

System.String

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

Title

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

System.String

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

UMCallingLineIds

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

Microsoft.Exchange.Data.MultiValuedProperty

Параметр UMCallingLineIds указывает телефонные номера или добавочные номера, которые можно сопоставить с пользователями единой системы обмена сообщениями. Для каждого пользователя можно указать несколько телефонных номеров, разделяя их запятыми. Значения этого параметра не должны превышать 128 цифровых символов и могут включать необязательный знак плюс (+), расположенный перед числами. Каждый пользователь единой системы обмена сообщениями должен иметь уникальное значение параметра UMCallingLineIds.

UMDtmfMap

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

Microsoft.Exchange.Data.MultiValuedProperty

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

UserPrincipalName

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

System.String

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

WebPage

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

System.String

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

WindowsEmailAddress

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

Microsoft.Exchange.Data.SmtpAddress

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

WindowsLiveID

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

Microsoft.Exchange.Data.SmtpAddress

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

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

Для запуска этого командлета необходимы соответствующие разрешения. В этом разделе перечислены все параметры командлета, однако некоторые из них могут быть недоступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях см. в разделе Подраздел «Разрешения подготовки получателей» в разделе Разрешения для почтового ящика.

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

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

Ошибки

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

  

 

Исключения

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

  

 

Примеры

ПРИМЕР 1

В этом примере задается краткое имя для пользователя Туманова Александра.

Скопировать код
Set-User -Identity Contoso\Jill -DisplayName "Jill Frank"