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"