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