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"