Set-Contact

Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и настройки могут отличаться в зависимости от среды.

Используйте командлет Set-Contact для изменения параметров объекта контакта. Если контакт является почтовым контактом, с помощью командлета Set-MailContact можно изменить другие параметры exchange Майкрософт, которые недоступны, с помощью командлета Set-Contact.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

Set-Contact
   [-Identity] <ContactIdParameter>
   [-AllowUMCallsFromNonUsers <AllowUMCallsFromNonUsersFlags>]
   [-AssistantName <String>]
   [-City <String>]
   [-Company <String>]
   [-Confirm]
   [-CountryOrRegion <CountryInfo>]
   [-CreateDTMFMap <Boolean>]
   [-Department <String>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-Fax <String>]
   [-FirstName <String>]
   [-GeoCoordinates <GeoCoordinates>]
   [-HomePhone <String>]
   [-IgnoreDefaultScope]
   [-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]
   [-WindowsEmailAddress <SmtpAddress>]
   [<CommonParameters>]

Описание

Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.

Примеры

Пример 1

Set-Contact -Identity "contoso.com/Users/Arlene Huff" -City "Seattle" -Company "Contoso"

В этом примере в существующий контакт с именем Arlene Huff в контейнере Пользователи в домене Active Directory contoso.com внесены следующие изменения:

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

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

Параметры

-AllowUMCallsFromNonUsers

Этот параметр доступен только в локальной среде Exchange.

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

Type:AllowUMCallsFromNonUsersFlags
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-AssistantName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-City

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Company

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Confirm

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

  • Деструктивные командлеты (например, командлеты Remove-*) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис: -Confirm:$false.
  • Большинство других командлетов (например, командлеты New-* и Set-*) не имеют встроенной приостановки. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-CountryOrRegion

Параметр CountryOrRegion указывает страну или регион контакта. Допустимым значением является допустимый двухбуквенный код страны ISO 3166-1 (например, AU для Австралии) или соответствующее понятное название страны (которое может отличаться от официального краткого названия АГЕНТСТВА по техническому обслуживанию ISO 3166).

Справочник по двухбуквенный кодов стран можно найти в списке кодов стран.

Понятное имя возвращается в значении свойства CountryOrRegion командлетом Get-Contact, но в операциях фильтрации можно использовать понятное имя или двухбуквенный код страны.

Type:CountryInfo
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-CreateDTMFMap

Этот параметр доступен только в локальной среде Exchange.

Параметр CreateDTMFMap указывает, следует ли создавать двухтонную карту с несколькими частотами (DTMF) для получателя. Это позволяет идентифицировать получателя с помощью клавиатуры телефона в средах единой системы обмена сообщениями. Допустимые значения:

  • $true: для получателя создается карта DTMF. Это значение используется по умолчанию.
  • $true. Для получателя создано сопоставление DTMF. Это значение по умолчанию.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Department

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-DisplayName

Параметр DisplayName указывает отображаемое имя контакта. Отображаемое имя показывается в Центре администрирования Exchange и в списках адресов. Максимальная длина имени составляет 256 символов. Если значение содержит пробелы, его необходимо заключить в кавычки (").

Этот параметр имеет смысл только в том случае, если контакт включен по почте.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-DomainController

Этот параметр доступен только в локальной среде Exchange.

Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Fax

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-FirstName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-GeoCoordinates

Параметр GeoCoordinates указывает расположение контакта в координатах широты, долготы и (при необходимости) высоты. Допустимое значение для этого параметра использует один из следующих форматов:

  • Широта и долгота: например, "47,644125;-122,122411"
  • Широта, долгота и высота: например, "47,644125;-122411;161,432"

Примечание. Если разделители периодов не работают, используйте вместо этого запятые.

Type:GeoCoordinates
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-HomePhone

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Identity

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

  • имя;
  • различающееся имя (DN);
  • различающееся имя (DN);
  • GUID
Type:ContactIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-IgnoreDefaultScope

Этот параметр доступен только в локальной среде Exchange.

Параметр IgnoreDefaultScope указывает команде игнорировать параметр области получателя по умолчанию для сеанса Exchange PowerShell и использовать в качестве области весь лес. Указывать значение для этого параметра необязательно.

Этот параметр позволяет команде получать доступ к объектам Active Directory, которые в настоящее время недоступны в области по умолчанию, но также вводит следующие ограничения:

  • При этом параметр DomainController использовать нельзя. Команда автоматически использует соответствующий сервер глобального каталога.
  • При этом параметр DomainController использовать нельзя. Команда автоматически использует соответствующий сервер глобального каталога.
Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Initials

Параметр Initials указывает отчество пользователя.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-LastName

Параметр LastName указывает фамилию пользователя.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Manager

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

Type:UserContactIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-MobilePhone

Параметр MobilePhone указывает основной номер мобильного телефона контакта.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Name

Параметр Name задает уникальное имя контакта. Максимальная длина: 64 символа. Если значение содержит пробелы, его необходимо заключить в кавычки (").

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Notes

Параметр Notes указывает дополнительные сведения об объекте. Если значение содержит пробелы, его необходимо заключить в кавычки (").

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Office

Параметр Office указывает имя или номер реального офиса пользователя.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-OtherFax

Параметр OtherFax указывает альтернативный номер факса контакта.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-OtherHomePhone

Параметр OtherHomePhone указывает альтернативный номер домашнего телефона контакта.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-OtherTelephone

Параметр OtherTelephone указывает альтернативный номер рабочего телефона контакта.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Pager

Параметр Pager указывает номер пейджера контакта.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Phone

Параметр Phone указывает номер рабочего телефона контакта.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-PhoneticDisplayName

Параметр PhoneticDisplayName определяет варианты правописания имени пользователя, которые используются для преобразования текста в речь в средах единой системы обмена сообщениями. Обычно этот параметр используется в случаях, когда произношение и правописание имени пользователя не совпадают. Максимальная длина имени составляет 256 символов. Если значение содержит пробелы, его необходимо заключить в кавычки (").

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-PostalCode

Параметр PostalCode указывает почтовый индекс контакта.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-PostOfficeBox

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

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-SeniorityIndex

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-SimpleDisplayName

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

  • Параметр SimpleDisplayName используется для отображения альтернативного описания объекта, если разрешен только ограниченный набор символов. Допустимые символы:
  • a–z
  • A–Z
  • Пробел
  • " ' ( ) + , - . / : ?

Этот параметр имеет смысл только в том случае, если контакт включен по почте.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-StateOrProvince

Параметр StateOrProvince указывает штат или провинцию контакта.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-StreetAddress

Параметр StreetAddress указывает реальный адрес контакта.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-TelephoneAssistant

Параметр TelephoneAssistant указывает номер телефона помощника контакта.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Title

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-UMCallingLineIds

Этот параметр доступен только в локальной среде Exchange.

Параметр UMCallingLineIds указывает номера телефонов или расширения, которые можно сопоставить с пользователем с поддержкой единой системы обмена сообщениями (UM). Для каждого пользователя можно указать несколько номеров телефонов, разделенных запятой. Значения для этого параметра должны быть менее 128 символов в длину и могут содержать необязательный знак "плюс" (+), который предшествует числам. Каждый пользователь с поддержкой единой системы обмена сообщениями должен иметь уникальное значение параметра UMCallingLineIds.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-UMDtmfMap

Этот параметр доступен только в локальной среде Exchange.

Параметр UMDtmfMap задает значения двухцветной многочастотной карты (DTMF) для получателя. Это позволяет идентифицировать получателя с помощью клавиатуры телефона в средах единой системы обмена сообщениями. Как правило, эти значения DTMF создаются и обновляются автоматически, но этот параметр можно использовать для внесения изменений вручную. Для этого параметра используется указанный ниже синтаксис.

  • emailAddress:<integers>
  • lastNameFirstName:<integers>
  • firstNameLastName:<integers>

Чтобы ввести значения, которые перезаписывают все существующие записи, используйте следующий синтаксис: emailAddress:<integers>,lastNameFirstName:<integers>,firstNameLastName:<integers>.

Если вы используете этот синтаксис и опустите какие-либо значения карты DTMF, эти значения удаляются из получателя. Например, если указать только emailAddress:<integers>, все существующие значения lastNameFirstName и firstNameLastName удаляются.

Чтобы добавить или удалить значения, не затрагивая другие существующие записи, используйте следующий синтаксис: @{Add="emailAddress:<integers>","lastNameFirstName:<integers>","firstNameLastName:<integers>"; Remove="emailAddress:<integers>","lastNameFirstName:<integers>","firstNameLastName:<integers>"}.

Если вы используете этот синтаксис, вам не нужно указывать все значения карты DTMF, и вы можете указать несколько значений карты DTMF. Например, можно использовать @{Add="emailAddress:<integers1>","emailAddress:<integers2>} для добавления двух новых значений для emailAddress, не затрагивая существующие значения lastNameFirstName и firstNameLastName.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-WebPage

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-WhatIf

Переключатель WhatIf имитирует действия команды. Вы можете использовать его для просмотра результатов изменений без фактического внесения этих изменений. С этим параметром не нужно указывать значение.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-WindowsEmailAddress

Параметр WindowsEmailAddress указывает адрес электронной почты Windows для этого получателя. Это общий атрибут Active Directory, который присутствует во всех средах, включая среды без Exchange. Использование параметра WindowsEmailAddress для получателя приводит к одному из следующих результатов:

  • В средах, где получатель подчиняется политикам адресов электронной почты (свойство EmailAddressPolicyEnabled имеет значение True для получателя), параметр WindowsEmailAddress не влияет на свойство WindowsEmailAddress или основное значение адреса электронной почты.
  • В средах, где получатель не подчиняется политикам адресов электронной почты (свойству EmailAddressPolicyEnabled задано значение False для получателя), параметр WindowsEmailAddress обновляет свойство WindowsEmailAddress и основной адрес электронной почты на то же значение.

Свойство WindowsEmailAddress отображается для получателя в Пользователи и компьютеры Active Directory в атрибуте E-mail. Общее имя атрибута — E-mail-Addresses, а ldap-Display-Name — mail. При изменении этого атрибута в Active Directory основной адрес электронной почты получателя не будет обновлен до того же значения.

Type:SmtpAddress
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

Входные данные

Input types

Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.

Выходные данные

Output types

Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.