Set-OfflineAddressBook (RTM)
适用于： Exchange Server 2007
上一次修改主题： 2007-06-05
使用 Set-OfflineAddressBook cmdlet 可以修改脱机通讯簿 (OAB) 设置。
语法
Set-OfflineAddressBook -Identity <OfflineAddressBookIdParameter> [-AddressLists <AddressBookBaseIdParameter[]>] [-DiffRetentionPeriod <Nullable>] [-DomainController <Fqdn>] [-IsDefault <$true | $false>] [-Name <String>] [-PublicFolderDistributionEnabled <$true | $false>] [-Schedule <Schedule>] [-Versions <Collection>] [-VirtualDirectories <VirtualDirectoryIdParameter[]>]
Set-OfflineAddressBook [-AddressLists <AddressBookBaseIdParameter[]>] [-DiffRetentionPeriod <Nullable>] [-DomainController <Fqdn>] [-Instance <OfflineAddressBook>] [-IsDefault <$true | $false>] [-Name <String>] [-PublicFolderDistributionEnabled <$true | $false>] [-Schedule <Schedule>] [-Versions <Collection>] [-VirtualDirectories <VirtualDirectoryIdParameter[]>]
详细说明
Set-OfflineAddressBook cmdlet 修改现有 OAB 的设置。对于与网络断开的时间非常长的用户来说，OAB 非常宝贵。OAB 是一个或多个地址列表的快照，MAPI 客户端可以下载它，以便在脱机时访问地址列表。
即使需要的时间超过了在 Schedule 参数中指定的时间，OAB 的生成过程也不会停止。
若要运行 Set-OfflineAddressBook cmdlet，必须为您使用的帐户委派以下角色：
- Exchange 组织管理员角色
有关管理 Exchange Server 2007 所需的权限、角色委派以及权利的详细信息，请参阅权限注意事项。
参数
| 参数 | 必需 | 类型 | 说明 |
|---|---|---|---|
Identity |
必需 |
Microsoft.Exchange.Configuration.Tasks.OfflineAddressBookIdParameter |
使用 Identity 参数指定代表特定脱机通讯簿的 GUID、可分辨名称或脱机通讯簿名称。还可以包含采用 Server\OfflineAddressBookName 格式的路径。 可以省略参数标签 Identity，以便只提供脱机通讯簿的名称或 GUID。 |
AddressLists |
可选 |
Microsoft.Exchange.Configuration.Tasks.AddressBookBaseIdParameter[] |
AddressLists 参数指定在 OAB 中包括的一组地址列表标识。 |
DiffRetentionPeriod |
可选 |
System.Nullable |
DiffRetentionPeriod 参数指定 OAB 差异文件在生成 OAB 的服务器和客户端访问服务器上保留的时间长度（天数）。若要无限期保留 OAB 差异文件，请使用值揢nlimited |
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 Server 2003、Exchange 2000 Server 和 Exchange Server version 5.5 客户端。 |
VirtualDirectories |
可选 |
Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter[] |
VirtualDirectories 参数指定一组 OABVirtualDirectory 对象。如果指定 VirtualDirectories 参数，则必须生成 Version4 OAB。 |
输入类型
返回类型
错误
| 错误 | 说明 |
|---|---|
|
异常
| 异常 | 说明 |
|---|---|
|
示例
此示例更改脱机通讯簿的名称。
Set-OfflineAddressBook -Identity "\Default Offline Address Book" -Name "My Offline Address Book"