Командлет 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 -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 [-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>]

Параметры

Параметр	Обязательность	Тип	Описание
Идентификатор	Обязательность	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 можно использовать для изменения параметров объектов контактов, которые отображены в оснастке «Пользователи и компьютеры Active Directory». Если для контакта включена поддержка почты, используйте командлет Set-MailContact для изменения параметров электронной почты контакта, которые недоступны при использовании командлета Set-Contact. Дополнительные сведения о командлете Set-MailContact см. в разделе Командлет Set-MailContact (окончательная первоначальная версия).

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

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

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

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

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

Ошибки

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

Исключения

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

Пример

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

Измените значение параметра «Город» на «Минск»;
Измените значение параметра «Организация» на «Contoso».

	Копировать код
Set-Contact -Identity "contoso.com/Users/Ted Bremer" -City "Seattle" -Company "Contoso"