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

Последнее изменение раздела: 2011-03-19

Командлет 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>] [-SeniorityIndex <Int32>] [-SimpleDisplayName <String>] [-StateOrProvince <String>] [-StreetAddress <String>] [-TelephoneAssistant <String>] [-Title <String>] [-UMCallingLineIds <MultiValuedProperty>] [-UMDtmfMap <MultiValuedProperty>] [-WebPage <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Параметры

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

Identity

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

Microsoft.Exchange.Configuration.Tasks.ContactIdParameter

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

  • GUID

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

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

  • Имя

AllowUMCallsFromNonUsers

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

Microsoft.Exchange.Data.Directory.Recipient.AllowUMCallsFromNonUsersFlags

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

AssistantName

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

System.String

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

City

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

System.String

Параметр City указывает город контакта.

Company

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

System.String

Параметр Company указывает компанию контакта.

Confirm

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

System.Management.Automation.SwitchParameter

CountryOrRegion

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

Microsoft.Exchange.Data.Directory.CountryInfo

Параметр CountryOrRegion указывает страну или регион контакта.

CreateDTMFMap

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

System.Boolean

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

Department

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

System.String

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

DisplayName

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

System.String

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

DomainController

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

Microsoft.Exchange.Data.Fqdn

Fax

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

System.String

Параметр Fax указывает номер факса контакта.

FirstName

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

System.String

Параметр FirstName указывает имя контакта.

HomePhone

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

System.String

Параметр HomePhone указывает номер домашнего телефона контакта.

IgnoreDefaultScope

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

System.Management.Automation.SwitchParameter

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

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

Initials

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

System.String

Параметр Initials указывает инициалы для имени контакта.

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

SeniorityIndex

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

System.Int32

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

SimpleDisplayName

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

System.String

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

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 для контакта единой системы обмена сообщениями.

WebPage

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

System.String

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

WhatIf

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

System.Management.Automation.SwitchParameter

WindowsEmailAddress

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

Microsoft.Exchange.Data.SmtpAddress

Параметр WindowsEmailAddress указывает адрес электронной почты контакта, хранящийся в Служба каталогов Active Directory.

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

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

Тема «Разрешения подготовки получателей» в разделе Разрешения для почтового ящика.

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

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

Ошибки

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

 

 

Примеры

ПРИМЕР 1

В этом примере в существующий контакт Arlene Huff в контейнере Users домена Служба каталогов Active Directory contoso.com вносятся следующие изменения:

  • Значение параметра City изменяется на Seattle.

  • Значение параметра Company изменяется на Contoso.

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