Reset-ProvisioningCache

参考

模块:: ExchangePowerShell

适用于:: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

此 cmdlet 仅适用于本地 Exchange。

Reset-ProvisioningCache cmdlet 清除常用 Active Directory 对象的Windows PowerShell预配缓存。此 cmdlet 仅用于诊断目的。

有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。

语法

Reset-ProvisioningCache
     [-Server] <Fqdn>
     -Application <String>
     [-GlobalCache]
     [-CacheKeys <MultiValuedProperty>]
     [-Confirm]
     [-WhatIf]
     [<CommonParameters>]

Reset-ProvisioningCache
     [-Server] <Fqdn>
     -Application <String>]
     [-CurrentOrganization]
     [-Organizations <MultiValuedProperty>]
     [-CacheKeys <MultiValuedProperty>]
     [-Confirm]
     [-WhatIf]
     [<CommonParameters>]

说明

Reset-ProvisioningCache cmdlet 仅用于诊断目的，极少使用。仅当新预配的收件人上标记了不正确的链接或属性时，Exchange 管理员才需要运行此 cmdlet，这可能由预配缓存中的过时数据引起。这种情况极少发生，因为设置缓存具有验证通知逻辑。

Reset-ProvisioningCache cmdlet 清除常用 Active Directory 对象的Windows PowerShell预配缓存。为了减少 Active Directory 请求，在每个Windows PowerShell运行空间中初始化预配缓存，并用于缓存 cmdlet 和预配处理程序经常使用的常见对象。在 Exchange cmdlet 执行期间，预配缓存从 Active Directory 加载配置对象以帮助运行 cmdlet。例如，创建邮箱时，New-Mailbox cmdlet 将从 Active Directory 获取属性。运行 cmdlet 时，将从 Active Directory 检索配置对象，例如数据库容器、管理角色组和 LegacyDN。由于这些类型的对象是稳定的，并且创建后的几个月或几年内不会更改，因此它们存储在 Windows PowerShell 使用的预配缓存中。这样可提高设置效率，显著提高 cmdlet 性能。

您必须先获得权限，然后才能运行此 cmdlet。虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。

示例

示例 1

Reset-ProvisioningCache -Server EXSRV1.contoso.com -Application Powershell -GlobalCache

本示例重置在本地 Exchange 组织中服务器 EXSRV1.contoso.com 上运行Windows PowerShell的预配缓存，并指定清除所有缓存密钥。

示例 2

Reset-ProvisioningCache -Application Powershell-Proxy -Server datacenter1.adatum.com -GlobalCache

此示例由数据中心管理员在多租户部署中运行，以重置 adatum.com 租户Windows PowerShell的预配缓存并清除所有缓存密钥。

参数

-Application

Application 参数指定要为其重置设置缓存的特定管理应用程序。可以使用下列值：

Powershell
Powershell-LiveId
Powershell-Proxy
PowershellLiveId-Proxy
Ecp
Psws

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-CacheKeys

CacheKeys 参数指定要清除的缓存关键字的值。该值的格式应包含用四个短划线分隔的 32 个数字：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

使用 Dump-ProvisioningCache cmdlet 可返回缓存关键字列表。

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Confirm

Confirm 开关指定是否显示确认提示。此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。

破坏性 cmdlet (例如，Remove-* cmdlet) 具有内置的暂停，该暂停会强制你在继续操作之前确认命令。对于这些 cmdlet，您可以使用此确切语法跳过确认提示：-Confirm:$false。
大多数其他 cmdlet (例如，New-* 和 Set-* cmdlet) 没有内置暂停。对于这些 cmdlet，指定不含值的 Confirm 开关会引入暂停，从而强制要求你先确认命令，然后再继续操作。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-CurrentOrganization

CurrentOrganization 开关重置组织的预配缓存。不必为此开关指定值。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-GlobalCache

GlobalCache 开关清除所有缓存密钥。不必为此开关指定值。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Organizations

Organizations 参数指定要重置设置缓存的组织。此参数在多租户部署中使用。

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Server

Server 参数指定在其上运行要重置的应用程序的服务器的完全限定域名 (FQDN)。

Type:	Fqdn
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-WhatIf

WhatIf 开关模拟命令操作。可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。不必为此开关指定值。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

输入

Input types

若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。

输出

Output types

若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。