New-OfflineAddressBook

 

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

上次修改主題的時間： 2008-01-21

使用 New-OfflineAddressBook 指令程式，可以建立新的離線通訊錄 (OAB)。

語法

New-OfflineAddressBook -Name <String> -AddressLists <AddressBookBaseIdParameter[]> -Server <ServerIdParameter> [-Confirm [<SwitchParameter>]] [-DiffRetentionPeriod <Nullable>] [-DomainController <Fqdn>] [-IsDefault <$true | $false>] [-PublicFolderDatabase <DatabaseIdParameter>] [-PublicFolderDistributionEnabled <$true | $false>] [-Schedule <Schedule>] [-SkipPublicFolderInitialization <SwitchParameter>] [-TemplateInstance <PSObject>] [-Versions <Collection>] [-VirtualDirectories <VirtualDirectoryIdParameter[]>] [-WhatIf [<SwitchParameter>]]

詳細描述

New-OfflineAddressBook 指令程式可讓系統管理員建立新的 OAB。例如，如果要解除安裝的 Client Access Server 含有 OAB，則需要在另一部 Client Access Server 上重新建立該 OAB。

若要執行 New-OfflineAddressBook 指令程式，必須對您使用的帳戶委派下列項目：

• Exchange 組織系統管理員角色

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

參數

參數	必要	類型	描述
AddressLists	必要	Microsoft.Exchange.Configuration.Tasks.AddressBookBaseIdParameter[]	AddressLists 參數可指定 OAB 中所含之通訊清單識別碼的陣列。
Name	必要	System.String	Name 參數指定用來說明 Exchange 系統管理員中之 OAB 物件的名稱 (最多 64 個字元)。
Server	必要	Microsoft.Exchange.Configuration.Tasks.ServerIdParameter	Server 參數指定要建立新 OAB 的伺服器。
Confirm	選用	System.Management.Automation.SwitchParameter	Confirm 參數會使得命令暫停處理，並要求確認命令將進行的動作之後才會繼續處理。您不需要為 Confirm 參數指定任何值。
DiffRetentionPeriod	選用	System.Nullable	DiffRetentionPeriod 參數指定在 OAB 產生伺服器及 Client Access Server 上保留 OAB 差異檔案的時間長度 (以天為單位)。若要無限期保留 OAB 差異檔案，請使用 "Unlimited" 值。
DomainController	選用	Microsoft.Exchange.Data.Fqdn	DomainController 參數指定要用於建立 OAB 的網域控制站。
IsDefault	選用	System.Boolean	如果 IsDefault 參數的值為 $true，則會將 OAB 設為所有新信箱資料庫的預設 OAB。如果值為 $false，則不會將 OAB 設為預設 OAB。
PublicFolderDatabase	選用	Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter	PublicFolderDatabase 參數指定公用資料夾資料庫的識別碼。
PublicFolderDistributionEnabled	選用	System.Boolean	如果 PublicFolderDistributionEnabled 參數的值為 $true，則會透過公用資料夾發佈 OAB。
Schedule	選用	Microsoft.Exchange.Data.Schedule	Schedule 參數指定為產生新 OAB 而排定的間隔。 Schedule 參數會採用下列格式，而且必須包含範圍：Weekday.Hour:Minute [AM/PM]-Weekday.Hour:Minute [AM/PM]。
SkipPublicFolderInitialization	選用	System.Management.Automation.SwitchParameter	如果您正在建立會使用公用資料夾發佈的 OAB，使用 SkipPublicFolderInitialization 參數可略過立即建立 OAB 公用資料夾。在下一個站台資料夾的維護週期完成之前，OAB 將無法下載。您不需要為 SkipPublicFolderInitialization 參數指定任何值。在 OAB 連絡負責的公用資料夾伺服器以建立必要的公用資料夾時，忽略此參數會導致工作暫停。如果目前無法存取伺服器，或是連絡成本高昂，暫停可能很重要。
TemplateInstance	選用	System.Management.Automation.PSObject	TemplateInstance 參數指定用來建立新 OAB 的範本。
Versions	選用	System.Collections.ObjectModel.Collection	Versions 參數指定要產生的 OAB 版本。允許的值為： Version1 Version2 Version3 Version4
VirtualDirectories	選用	Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter[]	VirtualDirectories 參數指定 OABVirtualDirectory 物件的陣列。如果己指定 VirtualDirectories 參數，則會產生 Version4 的 OAB。
WhatIf	選用	System.Management.Automation.SwitchParameter	WhatIf 參數指示命令模擬它將對物件採取的動作。使用 WhatIf 參數，則不需要套用任何變更，就能檢視變更。您不需要為 WhatIf 參數指定任何值。

輸入類型

傳回類型

錯誤

錯誤	描述

例外狀況

例外狀況	描述

範例

此範例會使用兩個命令來建立名為 OfflineAddressBook 的新 OAB，其中包含組織中所有可用的通訊清單。利用所顯示的設定，可以在星期一及星期三的 01:00 (早上 1 點) 到 02:00 (早上 2 點)，由 myserver.contoso.com 產生 OAB。該命令也會為組織建立預設 OAB。

$a = Get-AddressList
New-OfflineAddressBook -Name "OfflineAddressBook" -Server myserver.contoso.com -AddressLists $a -Schedule "Mon.01:00-Mon.02:00, Wed.01:00-Wed.02:00"