Командлет Update-Recipient позволяет добавить атрибуты Microsoft Exchange Server 2007 к объектам получателей, созданных агентом управления синхронизацией глобального списка адресов в Identity Lifecycle Manager (ILM) 2007. Объекты получателей, изменяемые с помощью этого командлета, должны находиться на сервере Exchange 2007.

Синтаксис


Update-Recipient -Identity <RecipientIdParameter> [-Confirm [<SwitchParameter>]] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]

Параметры

Параметр	Обязательный	Тип	Описание
Identity	Обязательный	Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter	Параметр Identity идентифицирует получателя. Можно использовать одно из следующих значений: GUID; домен\учетная_запись; имя участника-пользователя; устаревшее_различающееся_имя_Exchange; SMTP-адрес; имя; псевдоним.
Confirm	Необязательный	System.Management.Automation.SwitchParameter	Параметр Confirm используется для приостановки команды и требует подтверждения выполняемого ею действия. Указывать значение параметра Confirm не требуется.
Credential	Необязательный	System.Management.Automation.PSCredential	Параметр Credential указывает имя пользователя и пароль, которые необходимо использовать для доступа к Active Directory. Если используется параметр Credential, для продолжения выполнения команды требуется ввести пароль учетной записи.
DomainController	Необязательный	Microsoft.Exchange.Data.Fqdn	Чтобы задать полное доменное имя контроллера домена, который записывает эти изменения конфигурации в службу каталогов Active Directory, включите в команду параметр DomainController.
Server	Необязательный	Microsoft.Exchange.Configuration.Tasks.ServerIdParameter	Параметр Server указывает сервер, на котором будут выполняться выбранные операции.
WhatIf	Необязательный	System.Management.Automation.SwitchParameter	При использовании параметра WhatIf команда имитирует действия над объектом, которые она будет выполнять. Параметр WhatIf позволяет узнать, какие изменения произойдут, не применяя их. Указывать значение параметра WhatIf не требуется.

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

Из-за слияния или поглощения организаций, а также для соблюдения требований закона клиентам может потребоваться развернуть Exchange в топологии с несколькими лесами Exchange. При этом необходима синхронизация объектов получателей между отдельными лесами службы каталогов Active Directory. Дополнительные сведения о топологиях Exchange с несколькими лесами см. в разделе Планирование сложной организации Exchange.

Корпорация Майкрософт предлагает агент управления синхронизацией глобального списка адресов для синхронизации объектов получателей. Версия этого агента, которая входила в состав Microsoft Identity Integration Server (MIIS) 2003, была рассчитана на работу с Exchange Server 2003 и использовала службу обновления получателей. Так как служба обновления получателей устарела и не требуется для Exchange 2007, новый агент управления синхронизацией глобального списка адресов, который входит в состав ILM 2007, не использует ее.

В рамках процесса синхронизации агент управления синхронизацией глобального списка адресов создает объекты получателей в обоих лесах Active Directory. После создания получателей агент управления использует командлет Update-Recipient для добавления атрибутов, требуемых Exchange 2007, для завершения подготовки получателей к работе.

Примечание.
При использовании MIIS 2003 необходимо выполнить различные командлеты для завершения подготовки к работе почтовых контактов, созданных агентом управления синхронизацией глобального списка адресов. Дополнительные сведения об подготовке к работе почтовых контактов, созданных в MIIS 2003, см. в разделе Инструкции по развертыванию Exchange 2007 в топологии лесов с перекрестными связями. Командлет Update-Recipient позволяет выполнить эту операцию более эффективно. Для завершения подготовки к работе достаточно выполнить командлет Update-Recipient для объектов получателей, созданных агентом управления синхронизацией глобального списка адресов MIIS 2003.

Примечание.

При использовании MIIS 2003 необходимо выполнить различные командлеты для завершения подготовки к работе почтовых контактов, созданных агентом управления синхронизацией глобального списка адресов. Дополнительные сведения об подготовке к работе почтовых контактов, созданных в MIIS 2003, см. в разделе Инструкции по развертыванию Exchange 2007 в топологии лесов с перекрестными связями. Командлет Update-Recipient позволяет выполнить эту операцию более эффективно. Для завершения подготовки к работе достаточно выполнить командлет Update-Recipient для объектов получателей, созданных агентом управления синхронизацией глобального списка адресов MIIS 2003.

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

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

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

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

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

Ошибки

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

Пример

Первый пример показывает, как использовать командлет Update-Recipient для добавления атрибутов Exchange 2007 к почтовому контакту, который представляет почтовый ящик пользователя John Smith.

Во втором примере показано, как обновить все контакты в определенном подразделении. Предполагается, что выполняется синхронизация получателей в двух лесах (contoso.com и fabrikam.com), а также что все синхронизированные получатели из домена fabrikam.com хранятся в отдельном подразделении «fabrikam.com Users» в домене contoso.com.

	Копировать код
Update-Recipient -Identity "John Smith" Get-MailContact -OrganizationalUnit "contoso.com/fabrikam.com Users" \| Update-Recipient