Set-Contact

  • Статья

 

Применимо к: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Последнее изменение раздела: 2009-05-12

Командлет Set-Contact используется для изменения параметров существующего контакта.

Синтаксис

Set-Contact -Identity <ContactIdParameter> [-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>] [-SimpleDisplayName <String>] [-StateOrProvince <String>] [-StreetAddress <String>] [-TelephoneAssistant <String>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-UseRusServer <String>] [-WebPage <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Set-Contact [-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 <Contact>] [-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>] [-SimpleDisplayName <String>] [-StateOrProvince <String>] [-StreetAddress <String>] [-TelephoneAssistant <String>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-UseRusServer <String>] [-WebPage <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

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

Командлет Set-Contact можно использовать для изменения параметров объектов контактов, которые отображены в оснастке «Пользователи и компьютеры Active Directory». Если контакт поддерживает почту, используйте командлет Set-MailContact для изменения параметров электронной почты контакта, которые нельзя настроить с помощью командлета Set-Contact.

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

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

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

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

Параметры

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

Identity

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

Microsoft.Exchange.Configuration.Tasks.ContactIdParameter

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

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

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

  • Каноническое имя

  • Имя

Параметр Identity нельзя использовать в сочетании с параметром Instance.

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 позволяет задать имя контакта в консоли управления Exchange и в глобальном списке адресов Exchange. Параметр DisplayName имеет значение только для объектов, разрешенных в единой системе обмена сообщениями.

DomainController

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

Microsoft.Exchange.Data.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 действуют ограничения, описанные ниже.

  • Использовать параметр DomainController нельзя. Команда автоматически будет использовать подходящий сервер глобального каталога.

  • В качестве значения параметра Identity можно использовать только различающееся имя. Другие формы идентификации, например с помощью псевдонима или идентификатора GUID, не допускаются.

Initials

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

System.String

Параметр Initials определяет имя контакта.

Instance

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

Microsoft.Exchange.Data.Directory.Management.Contact

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

Параметр Instance нельзя использовать в сочетании с параметром Identity.

LastName

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

System.String

Параметр LastName определяет фамилию контакта.

Manager

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

Microsoft.Exchange.Configuration.Tasks.UserContactIdParameter

Параметр Manager определяет руководителя контакта.

MobilePhone

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

System.String

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

Name

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

System.String

Параметр Name указывает имя контакта в оснастке Active Directory «Пользователи и компьютеры», а также в поле Имя группы в консоли управления Exchange, если для группы включена поддержка почты.

Значение Name не может превышать в длину 64 знаков.

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 определяет номер почтового ящика в адресе контакта.

SimpleDisplayName

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

System.String

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

abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789\"()+,-./:?

Параметр SimpleDisplayName имеет значение только для объектов, разрешенных в единой системе обмена сообщениями.

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 для контакта, поддерживающего единую систему обмена сообщениями.

UseRusServer

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

System.String
noteПримечание.
Этот параметр доступен только в Exchange 2007 с пакетом обновления 2 (SP2).

Параметр 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 определяет почтовый адрес контакта, хранящийся в Active Directory.

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

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

Ошибки

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

 

 

Исключения

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

 

 

Пример

В следующем примере кода показано, как использовать команду Set-Contact для изменения существующего контакта Ted Bremer в контейнере Users в домене Active Directory contoso.com:

  • Измените значение параметра «Город» на «Минск»;

  • Измените значение параметра «Организация» на «Contoso».

Set-Contact -Identity "contoso.com/Users/Ted Bremer" -City "Seattle" -Company "Contoso"