New-OfflineAddressBook

 

适用于： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

上一次修改主题： 2008-01-21

使用 New-OfflineAddressBook cmdlet 可以新建脱机通讯簿 (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 cmdlet，管理员可以创建新 OAB。 例如，如果卸载包含 OAB 的客户端访问服务器，则需要在另一个客户端访问服务器上重新创建它。

要运行 New-OfflineAddressBook cmdlet，必须为您使用的帐户委派以下角色：

• 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 差异文件在生成 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 参数指定值。 如果省略此参数，可能会导致任务在联系负责的公用文件夹服务器以创建必需的公用文件夹时暂停。 如果目前无法访问服务器，或者联系成本太高，则应该暂停。
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 参数，则必须生成 OAB 的 Version4。
WhatIf	可选	System.Management.Automation.SwitchParameter	WhatIf 参数指示命令模拟针对对象执行的操作。 通过使用 WhatIf 参数，您可以查看要发生的更改，而不必应用任何这些更改。 您不必使用 WhatIf 参数指定值。

输入类型

返回类型

错误

错误	说明

异常

异常	说明

示例

此示例使用两个命令来新建名为 OfflineAddressBook 的 OAB，其中包括组织内的所有可用地址列表。 按照所示进行设置后，在周一和周三的每天 01:00（上午 1:00）到 02:00（上午 2:00）由 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"