Disconnect-CMTrackedObject
清除未使用的PowerShell物件,以避免SMS提供者配額違規錯誤。
語法
Disconnect-CMTrackedObject
[-Force]
-InputObject <IDisposable[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Disconnect-CMTrackedObject
[-All]
[-Force]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
當您使用 Start-CMObjectTracking 來追蹤 PowerShell 執行時間所使用的 SMS 提供者物件時,請使用此 Cmdlet 在不再需要這些資源時加以清除。
當您執行 Start-CMObjectTracking 時,PowerShell 運行時間會追蹤 Configuration Manager Cmdlet 所建立的 IResultObject 物件。 對於未使用 .Dispose()
手動清除的物件,請針對個別物件使用 Disconnect-CMTrackedObject 來回收它們。
回收物件之後,就無法再透過物件管線重複使用或傳遞至另一個 Cmdlet。
Stop-CMObjectTracking 可用來關閉對象追蹤。 先前配置的物件會保持作用中狀態。
未宣告的資源可能會導致SMS提供者引發配額違規錯誤。 這些配額問題通常來自於使用大型SMS提供者物件集合或長時間執行的環境中。
注意事項
這項功能是實驗性的,未來版本可能會變更或移除。
從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet,例如 PS XYZ:\>
。 如需詳細資訊,請 參閱開始使用。
範例
範例 1
第一個命令會開啟對象追蹤。 第二個命令會回收$obj變數所指定 的單一 物件。 第三個命令會回收所有追蹤的物件。 最後一個命令會關閉對象追蹤。
Start-CMObjectTracking
# Reclaim a single tracked object
$obj | Disconnect-CMTrackedObject -Force
# Reclaim all tracked objects
Disconnect-CMTrackedObject -All
Stop-CMObjectTracking
參數
-All
新增此參數以回收所有追蹤的物件。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-Confirm
新增此參數,以在 Cmdlet 執行之前提示確認。
類型: | SwitchParameter |
別名: | cf |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DisableWildcardHandling
此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Force
新增此參數以執行命令,而不要求確認。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ForceWildcardHandling
此參數會處理通配符,並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-InputObject
指定您先前使用 Configuration Manager Cmdlet 建立的任何 IResultObject 。
類型: | IDisposable[] |
別名: | InputObjects |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。
類型: | SwitchParameter |
別名: | wi |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
輸入
System.IDisposable[]
輸出
System.Object