Update-Recipient

 

適用版本: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

上次修改主題的時間: 2007-07-18

使用 Update-Recipient 指令程式,可將 Microsoft Exchange Server 2007 屬性新增至 Identity Lifecycle Manager (ILM) 2007 中的全域通訊清單 (GAL) 同步處理管理代理程式所建立的收件者物件。您使用此指令程式來修改的收件者物件必須位於 Exchange 2007 伺服器上。

語法

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

詳細描述

基於合併和收購或法律要求,客戶可能需要在多重 Exchange 樹系拓撲中部署 Exchange。這些部署需要跨不同的 Active Directory 目錄服務樹系來同步收件者物件。若要深入了解多重 Exchange 樹系拓撲,請參閱複雜 Exchange 組織的規劃

Microsoft 提供 GAL 同步處理管理代理程式以同步收件者物件。Microsoft Identity Integration Server (MIIS) 2003 內含的 GAL 同步處理管理代理程式版本是針對用於 Exchange Server 2003 而設計,且依賴收件者更新服務 (RUS)。因為 RUS 是過時的功能,在 Exchange 2007 中已不再需要使用,所以 ILM 2007 內含的新的 GAL 同步處理管理代理程式,已設計成不需要 RUS 即可執行。

在同步處理程序中,ILM 2007 GAL 同步處理管理代理程式會同時在兩個 Active Directory 樹系中建立收件者物件。在建立收件者之後,管理代理程式會使用 Update-Recipient 指令程式來新增 Exchange 2007 所需的屬性,以完成這些收件者的提供程序。

note附註:
如果使用 MIIS 2003,則必須執行各種指令程式,以完成 GAL 同步處理管理代理程式所建立之郵件連絡人的提供程序。如需提供 MIIS 2003 所建立之郵件連絡人的詳細資訊,請參閱如何在跨樹系拓撲中部署 Exchange 2007Update-Recipient 指令程式提供另一種更有效率的方法來完成此工作。您只需要對 MIIS 2003 GAL 同步處理管理代理程式所建立的收件者物件執行 Update-Recipient 指令程式,即可完成提供程序。

若要執行 Update-Recipient 指令程式,您使用的帳戶必須已獲委派下列角色:

  • Exchange 收件者系統管理員角色

如需管理 Exchange 2007 所需之權限、委派角色以及權利的相關資訊,請參閱權限考量

參數

參數 必要 類型 描述

Identity

必要

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

Identity 參數會識別收件者。您可以使用下列其中一個值:

  • GUID

  • 網域\帳戶

  • 使用者主要名稱 (UPN)

  • LegacyExchangeDN

  • 簡易郵件傳送通訊協定 (SMTP) 位址

  • 名稱

  • 別名

Confirm

選用

System.Management.Automation.SwitchParameter

Confirm 參數會使得命令暫停處理,並要求確認命令將進行的動作之後才會繼續處理。您不需要為 Confirm 參數指定任何值。

Credential

選用

System.Management.Automation.PSCredential

Credential 參數可指定用於存取 Active Directory 的使用者名稱與密碼。

如果使用 Credential 參數,則在繼續之前,命令會先提示輸入帳戶的密碼。

DomainController

選用

Microsoft.Exchange.Data.Fqdn

若要指定將此組態變更寫入至 Active Directory 之網域控制站的網域全名 (FQDN),請在命令中加入 DomainController 參數。

Server

選用

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Server 參數可指定執行所選取之作業的伺服器。

WhatIf

選用

System.Management.Automation.SwitchParameter

WhatIf 參數指示命令模擬它將對物件採取的動作。使用 WhatIf 參數,則不需要套用任何變更,就能檢視變更。您不需要為 WhatIf 參數指定任何值。

輸入類型

傳回類型

錯誤

錯誤 描述

 

範例

第一個範例顯示如何使用 Update-Recipient 指令程式,將 Exchange 2007 屬性新增至代表 John Smith 信箱的郵件連絡人。

第二個範例顯示如何更新特定組織單位 (OU) 中的所有連絡人。此範例假設是在 contoso.com 和 fabrikam.com 樹系之間同步收件者,且來自 fabrikam.com 網域的所有同步收件者,皆儲存在 contoso.com 網域中的一個稱為 fabrikam.com Users 的特定 OU 中。

Update-Recipient -Identity "John Smith"
Get-MailContact -OrganizationalUnit "contoso.com/fabrikam.com Users" | Update-Recipient