通过

New-OfflineAddressBook (RTM)

  • 项目

 

适用于： Exchange Server 2007

上一次修改主题： 2007-06-05

使用 New-OfflineAddressBook cmdlet 可以新建脱机通讯簿 (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 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 的服务器。

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]。

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。

输入类型

返回类型

错误

错误 说明

 

异常

异常 说明

 

示例

此示例使用两个命令来新建名为 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"