Set-OfflineAddressBook

 

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

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

使用 Set-OfflineAddressBook 指令程式來修改離線通訊錄 (OAB) 設定。

語法

Set-OfflineAddressBook -Identity <OfflineAddressBookIdParameter> [-AddressLists <AddressBookBaseIdParameter[]>] [-ApplyMandatoryProperties <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DiffRetentionPeriod <Nullable>] [-DomainController <Fqdn>] [-IsDefault <$true | $false>] [-Name <String>] [-PublicFolderDistributionEnabled <$true | $false>] [-Schedule <Schedule>] [-Versions <Collection>] [-VirtualDirectories <VirtualDirectoryIdParameter[]>] [-WhatIf [<SwitchParameter>]]

Set-OfflineAddressBook [-AddressLists <AddressBookBaseIdParameter[]>] [-ApplyMandatoryProperties <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DiffRetentionPeriod <Nullable>] [-DomainController <Fqdn>] [-Instance <OfflineAddressBook>] [-IsDefault <$true | $false>] [-Name <String>] [-PublicFolderDistributionEnabled <$true | $false>] [-Schedule <Schedule>] [-Versions <Collection>] [-VirtualDirectories <VirtualDirectoryIdParameter[]>] [-WhatIf [<SwitchParameter>]]

詳細描述

Set-OfflineAddressBook 指令程式會修改現有 OAB 的設定。OAB 對於因為網路中斷連線而花費大量時間的使用者來說十分寶貴。OAB 是一或多個通訊清單的快照集,MAPI 用戶端在下載後可以在離線時存取此通訊清單。

即使所需的時間多於 Schedule 參數中指定的時間,也不會停止產生 OAB。

若要執行 Set-OfflineAddressBook 指令程式,您使用的帳戶必須已委派下列資格:

  • Exchange 組織系統管理員角色

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

參數

參數 必要 類型 描述

Identity

必要

Microsoft.Exchange.Configuration.Tasks.OfflineAddressBookIdParameter

使用 Identity 參數,可以指定代表特定 OAB 的 GUID、辨別名稱或 OAB 名稱。您也可以使用 Server\OfflineAddressBookName 的格式加入路徑。

您可以省略參數標籤 Identity,而只提供 OAB 名稱或 GUID。

AddressLists

選用

Microsoft.Exchange.Configuration.Tasks.AddressBookBaseIdParameter[]

AddressLists 參數指定 OAB 中所含之通訊清單識別碼的陣列。

ApplyMandatoryProperties

選用

System.Management.Automation.SwitchParameter

不支援透過 Exchange Server 2003 Exchange 系統管理員建立 Exchange 2007 OAB。如果是使用此工具建立 Exchange 2007 OAB,則即使是位在 Exchange 2007 伺服器上,仍然會將它識別為舊版 OAB。使用 ApplyMandatoryProperties 參數來修改此狀態之 OAB 的必要內容,以更正問題。

Confirm

選用

System.Management.Automation.SwitchParameter

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

DiffRetentionPeriod

選用

System.Nullable

DiffRetentionPeriod 參數指定在 OAB 產生伺服器及 Client Access Server 上保留 OAB 差異檔案的時間長度 (以天為單位)。若要無限期保留 OAB 差異檔案,請使用 "Unlimited" 值。

DomainController

選用

Microsoft.Exchange.Data.Fqdn

若要指定從 Active Directory 目錄服務擷取資料之網域控制站的網域全名 (FQDN),請在命令中加入 DomainController 參數。

Instance

選用

Microsoft.Exchange.Data.Directory.SystemConfiguration.OfflineAddressBook

Instance 參數可讓您將整個物件傳遞至要處理的命令。它主要是用於必須將整個物件傳遞至該命令的指令碼。

IsDefault

選用

System.Boolean

IsDefault 參數會將此 OAB 設定為所有新信箱儲存區的預設 OAB。

Name

選用

System.String

Name 參數設定新 OAB 的新名稱。名稱會顯示在 Exchange 管理主控台中。Name 參數值最多可包含 64 個字元。

PublicFolderDistributionEnabled

選用

System.Boolean

PublicFolderDistributionEnabled 參數設為值 $true,可將 OAB 設為透過公用資料夾散佈。預設值為 $true。

Schedule

選用

Microsoft.Exchange.Data.Schedule

Schedule 參數指定為產生 OAB 而排定的間隔。

Schedule 參數會採用下列格式,而且必須包含範圍:Weekday.Hour:Minute [AM/PM]-Weekday.Hour:Minute [AM/PM]。

Versions

選用

System.Collections.ObjectModel.Collection

Versions 參數指定產生以供用戶端下載的 OAB 版本。可用的選項為 Version4、Version3 及 Version2。第 4 版是供 Microsoft Office Outlook 2007 或 Office Outlook 2003 Service Pack 2 (SP2) 用戶端使用。第 3 版是供支援 Unicode 的 Outlook 用戶端使用。第 2 版則是供 Microsoft Exchange Server 2007、Exchange 2003、Exchange 2000 Server 及 Exchange Server version 5.5 用戶端使用。

VirtualDirectories

選用

Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter[]

VirtualDirectories 參數指定 OABVirtualDirectory 物件的陣列。如果指定了 VirtualDirectories 參數,就必須產生 OAB 的 Version4。

WhatIf

選用

System.Management.Automation.SwitchParameter

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

輸入類型

傳回類型

錯誤

錯誤 描述

 

例外狀況

例外狀況 描述

 

範例

此範例會變更 OAB 的名稱。

Set-OfflineAddressBook -Identity "\Default Offline Address Book" -Name "My Offline Address Book"

若要確保您目前閱讀的是最新資訊,並尋找其他的 Exchange Server 2007 說明文件,請造訪 Exchange Server 技術資源中心.