Reset-ProvisioningCache
內部部署 Exchange 才有提供此 Cmdlet。
Reset-ProvisioningCache Cmdlet 會清除常用 Active Directory 物件的 Windows PowerShell 布建快取。 此指令程式僅用於診斷目的。
如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。
語法
GlobalCache
Reset-ProvisioningCache
[-Server] <Fqdn>
-Application <String>
[-GlobalCache]
[-CacheKeys <MultiValuedProperty>]
[-Confirm]
[-WhatIf]
[<CommonParameters>]
OrganizationCache
Reset-ProvisioningCache
[-Server] <Fqdn>
-Application <String>
[-CurrentOrganization]
[-Organizations <MultiValuedProperty>]
[-CacheKeys <MultiValuedProperty>]
[-Confirm]
[-WhatIf]
[<CommonParameters>]
Description
Reset-ProvisioningCache 指令程式僅用於診斷用途,且極少使用。 只有在新布建的收件者上加上不正確的連結或屬性戳記時,Exchange 系統管理員才需要執行此 Cmdlet,這可能是由布建快取中的過時數據所造成。 此情況極少發生,因為佈建快取有無效通知邏輯。
Reset-ProvisioningCache Cmdlet 會清除常用 Active Directory 物件的 Windows PowerShell 布建快取。 為了減少 Active Directory 要求,布建快取會在每個 Windows PowerShell Runspace 中初始化,並用來快取 Cmdlet 和布建處理程式經常使用的一般物件。 在 Exchange Cmdlet 執行期間,布建快取會從 Active Directory 載入組態物件,以協助執行 Cmdlet。 例如,當您建立信箱時,New-Mailbox Cmdlet 會從 Active Directory 取得屬性。 執行 Cmdlet 時,會從 Active Directory 擷取設定物件,例如資料庫容器、系統管理角色群組和 LegacyDN。 因為這些類型的對像是穩定的,而且在建立之後的幾個月或幾年內不會變更,所以它們會儲存在 Windows PowerShell 所使用的布建快取中。 這將增加佈建效率並大幅加強指令程式效能。
您必須已獲指派權限,才能執行此指令程式。 雖然本文列出 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
適用:Exchange Server 2013 年 Exchange Server 2016 年 Exchange Server 2019 年
Application 參數會指定特定管理應用程式以重設佈建快取。 您可以使用下列值:
- Powershell
- Powershell-LiveId
- Powershell-Proxy
- PowershellLiveId-Proxy
- Ecp
- Psws
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-CacheKeys
適用:Exchange Server 2013 年 Exchange Server 2016 年 Exchange Server 2019 年
CacheKeys 參數將指定您想要清除的快取金鑰的值。 這些值的格式應包含 32 個由四個破折號分隔的數字:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
使用Dump-ProvisioningCache 指令程式來傳回快取金鑰的清單。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Confirm
適用:Exchange Server 2013 年 Exchange Server 2016 年 Exchange Server 2019 年
Confirm 參數會指定要顯示或隱藏確認提示。 這個參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續作業。
- 破壞性的 Cmdlet (如 Remove-* cmdlets) 有內建暫停,它會先強迫您確認命令才會繼續作業。 對於這些 Cmdlet,您可以使用以下確切語法來略過確認提示:
-Confirm:$false。 - 其他大部分的 Cmdlet (如 New-* 和 Set-* cmdlets) 則沒有內建暫停。 在使用這些 Cmdlet 時,指定不含任何值的 Confirm 參數會引入強迫您認可命令後才繼續作業的暫停。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | cf |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-CurrentOrganization
適用:Exchange Server 2013 年 Exchange Server 2016 年 Exchange Server 2019 年
CurrentOrganization 參數會重設組織的布建快取。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
OrganizationCache
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-GlobalCache
適用:Exchange Server 2013 年 Exchange Server 2016 年 Exchange Server 2019 年
GlobalCache 參數會清除所有快取金鑰。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
GlobalCache
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Organizations
適用:Exchange Server 2013 年 Exchange Server 2016 年 Exchange Server 2019 年
Organizations 參數會指定重設布建快取的組織。 在多租使用者部署中使用此參數。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
OrganizationCache
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Server
適用:Exchange Server 2013 年 Exchange Server 2016 年 Exchange Server 2019 年
Server 參數將指定伺服器的完整網域名稱 (FQDN),此伺服器為您想要重設的應用程式所執行的位置。
參數屬性
| 類型: | Fqdn |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-WhatIf
適用:Exchange Server 2013 年 Exchange Server 2016 年 Exchange Server 2019 年
WhatIf 參數會模擬命令的動作。 使用此參數時,您不需要實際套用變更即可檢視可能會發生的變更。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 無線 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。
輸入
Input types
若要查看此指令程式可接受的輸入類型,請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的,表示指令程式不接受輸入資料。
輸出
Output types
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型),請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的,表示指令程式不會傳回資料。