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


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

 

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

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

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

Синтаксис

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

Set-Contact [-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 <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>] [-WebPage <String>]

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

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

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

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

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

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

Параметры

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

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

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

Microsoft.Exchange.Configuration.Tasks.ContactIdParameter

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

  • GUID;

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

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

  • Имя

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

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

DomainController

Дополнительно

Microsoft.Exchange.Data.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.Contact

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

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

LastName

Дополнительно

System.String

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

Диспетчер

Дополнительно

Microsoft.Exchange.Configuration.Tasks.UserContactIdParameter

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

MobilePhone

Дополнительно

System.String

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

Имя

Дополнительно

System.String

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

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

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

SimpleDisplayName

Дополнительно

System.String

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

StateOrProvince

Дополнительно

System.String

Параметр StateOrProvince определяет область или район контакта.

StreetAddress

Дополнительно

System.String

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

TelephoneAssistant

Дополнительно

System.String

Параметр TelephoneAssistant определят телефонный номер помощника контакта.

Название

Дополнительно

System.String

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

UMDialPlan

Дополнительно

Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter

Этот параметр определяет идентификатор объекта каталога для абонентской группы.

UMDtmfMap

Дополнительно

Microsoft.Exchange.Data.MultiValuedProperty

Этот параметр определяет, будет ли создано пользовательское сопоставление DTMF для контакта, поддерживающего единую систему обмена сообщениями.

WebPage

Дополнительно

System.String

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

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

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

Ошибки

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

 

 

Исключения

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

 

 

Пример

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

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

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

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