Disconnect-CMTrackedObject

  • 參考
模組:
ConfigurationManager

清除未使用的 PowerShell 物件，以避免 SMS 提供者配額違規錯誤。

Syntax

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

新增此參數以回收所有追蹤的物件。

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

新增此參數，以在 Cmdlet 執行之前提示確認。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

此參數會將萬用字元視為常值字元值。 您無法將其與 ForceWildcardHandling結合。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

新增此參數以執行命令，而不要求確認。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

此參數會處理萬用字元，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling結合。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

指定您先前使用 Configuration Manager Cmdlet 建立的任何IResultObject。

Type:IDisposable[]
Aliases:InputObjects
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

輸入

System.IDisposable[]

輸出

System.Object