Set-OfflineAddressBook

 

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

上一次修改主题: 2007-07-05

使用 Set-OfflineAddressBook cmdlet 可以修改脱机通讯簿 (OAB) 设置。

语法

Set-OfflineAddressBook -Identity <OfflineAddressBookIdParameter> [-AddressLists <AddressBookBaseIdParameter[]>] [-ApplyMandatoryProperties <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DiffRetentionPeriod <Nullable>] [-DomainController <Fqdn>] [-IsDefault <$true | $false>] [-Name <String>] [-PublicFolderDistributionEnabled <$true | $false>] [-Schedule <Schedule>] [-Versions <Collection>] [-VirtualDirectories <VirtualDirectoryIdParameter[]>] [-WhatIf [<SwitchParameter>]]

Set-OfflineAddressBook [-AddressLists <AddressBookBaseIdParameter[]>] [-ApplyMandatoryProperties <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DiffRetentionPeriod <Nullable>] [-DomainController <Fqdn>] [-Instance <OfflineAddressBook>] [-IsDefault <$true | $false>] [-Name <String>] [-PublicFolderDistributionEnabled <$true | $false>] [-Schedule <Schedule>] [-Versions <Collection>] [-VirtualDirectories <VirtualDirectoryIdParameter[]>] [-WhatIf [<SwitchParameter>]]

详细说明

Set-OfflineAddressBook cmdlet 修改现有 OAB 的设置。对于与网络断开的时间非常长的用户来说,OAB 非常宝贵。OAB 是一个或多个地址列表的快照,MAPI 客户端可以下载它,以便在脱机时访问地址列表。

即使需要的时间超过了在 Schedule 参数中指定的时间,OAB 的生成过程也不会停止。

若要运行 Set-OfflineAddressBook cmdlet,必须为您使用的帐户委派以下角色:

  • Exchange 组织管理员角色

有关权限、角色委派以及管理 Microsoft Exchange Server 2007 所需权限的详细信息,请参阅权限注意事项

参数

参数 必需 类型 说明

Identity

必需

Microsoft.Exchange.Configuration.Tasks.OfflineAddressBookIdParameter

使用 Identity 参数指定代表特定 OAB 的 GUID、可分辨名称或 OAB 名称。还可以包含采用 Server\OfflineAddressBookName 格式的路径。

可以省略参数标签 Identity,以便只提供 OAB 名称或 GUID。

AddressLists

可选

Microsoft.Exchange.Configuration.Tasks.AddressBookBaseIdParameter[]

AddressLists 参数指定在 OAB 中包括的一组地址列表标识。

ApplyMandatoryProperties

可选

System.Management.Automation.SwitchParameter

不支持通过 Exchange Server 2003 Exchange 系统管理器创建 Exchange 2007 OAB。如果 Exchange 2007 OAB 是使用此工具创建的,即使它驻留在 Exchange 2007 服务器上,也将被标识为旧版 OAB。请使用 ApplyMandatoryProperties 参数在此状态下修改 OAB 的强制属性,以更正问题。

Confirm

可选

System.Management.Automation.SwitchParameter

Confirm 参数将导致命令暂停处理,并且需要您在处理继续之前确认该命令将执行的操作。不必为 Confirm 参数指定值。

DiffRetentionPeriod

可选

System.Nullable

DiffRetentionPeriod 参数指定 OAB 差异文件在生成 OAB 的服务器和客户端访问服务器上保留的时间长度(天数)。若要无限期保留 OAB 差异文件,请使用值“Unlimited”。

DomainController

可选

Microsoft.Exchange.Data.Fqdn

若要指定用于从 Active Directory 目录服务检索数据的域控制器的完全限定的域名 (FQDN),请在命令中包含 DomainController 参数。

Instance

可选

Microsoft.Exchange.Data.Directory.SystemConfiguration.OfflineAddressBook

使用 Instance 参数可以将整个对象传递给此命令以进行处理。该参数主要用于必须将整个对象传递给命令的脚本。

IsDefault

可选

System.Boolean

IsDefault 参数将此 OAB 设置为所有新邮箱存储的默认 OAB。

Name

可选

System.String

Name 参数设置 OAB 的新名称。该名称将出现在 Exchange 管理控制台中。Name 参数值最多可以包含 64 个字符。

PublicFolderDistributionEnabled

可选

System.Boolean

PublicFolderDistributionEnabled 参数的值设置为 $true 时,会将 OAB 设置为通过公用文件夹进行分发。默认值为 $true。

Schedule

可选

Microsoft.Exchange.Data.Schedule

Schedule 参数指定生成 OAB 的计划间隔。

Schedule 参数采用以下格式并且必须包含范围:Weekday.Hour:Minute [AM/PM]-Weekday.Hour:Minute [AM/PM]。

Versions

可选

System.Collections.ObjectModel.Collection

Versions 参数指定为客户端下载所生成的 OAB 版本。可用选项是 Version4、Version3 和 Version2。Version4 用于 Microsoft Office Outlook 2007 或 Office Outlook 2003 Service Pack 2 (SP2) 客户端。Version3 用于支持 Unicode 的 Outlook 客户端。Version2 用于 Microsoft Exchange Server 2007、Exchange 2003、Exchange 2000 Server 和 Exchange Server version 5.5 客户端。

VirtualDirectories

可选

Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter[]

VirtualDirectories 参数指定一组 OABVirtualDirectory 对象。如果指定 VirtualDirectories 参数,则必须生成 Version4 OAB。

WhatIf

可选

System.Management.Automation.SwitchParameter

WhatIf 参数指示命令模拟对对象执行的操作。通过使用 WhatIf 参数,您可以查看要发生的更改,而不必应用任何这些更改。不必为 WhatIf 参数指定值。

输入类型

返回类型

错误

错误 说明

 

异常

异常 说明

 

示例

此示例更改 OAB 的名称。

Set-OfflineAddressBook -Identity "\Default Offline Address Book" -Name "My Offline Address Book"