New-OfflineAddressBook (RTM)
適用版本: Exchange Server 2007
上次修改主題的時間: 2007-06-05
使用 New-OfflineAddressBook 指令程式,可以建立新的離線通訊錄 (OAB)。
語法
New-OfflineAddressBook -Name <String> -AddressLists <AddressBookBaseIdParameter[]> -Server <ServerIdParameter> [-DiffRetentionPeriod <Nullable>] [-DomainController <Fqdn>] [-IsDefault <$true | $false>] [-PublicFolderDatabase <DatabaseIdParameter>] [-PublicFolderDistributionEnabled <$true | $false>] [-Schedule <Schedule>] [-TemplateInstance <PSObject>] [-Versions <Collection>] [-VirtualDirectories <VirtualDirectoryIdParameter[]>]
詳細描述
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 的伺服器。 |
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 參數的值為 |
Schedule |
選用 |
Microsoft.Exchange.Data.Schedule |
Schedule 參數指定為產生新 OAB 而排定的間隔。 Schedule 參數會採用下列格式,而且必須包含範圍:Weekday.Hour:Minute [AM/PM]-Weekday.Hour:Minute [AM/PM]。 |
TemplateInstance |
選用 |
System.Management.Automation.PSObject |
TemplateInstance 參數指定用來建立新 OAB 的範本。 |
Versions |
選用 |
System.Collections.ObjectModel.Collection |
Versions 參數指定要產生的 OAB 版本。允許的值為:
|
VirtualDirectories |
選用 |
Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter[] |
VirtualDirectories 參數指定 OABVirtualDirectory 物件的陣列。如果己指定 VirtualDirectories 參數,則會產生 Version4 的 OAB。 |
輸入類型
傳回類型
錯誤
錯誤 | 描述 |
---|---|
|
例外狀況
例外狀況 | 描述 |
---|---|
|
範例
此範例會使用兩個命令來建立名為 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"