Disconnect-CMTrackedObject

  • リファレンス
モジュール:
ConfigurationManager

未使用の PowerShell オブジェクトをクリーンアップして、SMS プロバイダーのクォータ違反エラーを回避します。

構文

Disconnect-CMTrackedObject
          [-Force]
          -InputObject <IDisposable[]>
          [-DisableWildcardHandling]
          [-ForceWildcardHandling]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]
Disconnect-CMTrackedObject
          [-All]
          [-Force]
          [-DisableWildcardHandling]
          [-ForceWildcardHandling]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]

説明

Start-CMObjectTrackingを使用して PowerShell ランタイムで使用される SMS プロバイダー オブジェクトを追跡する場合は、このコマンドレットを使用して、不要になったリソースをクリーンアップします。

Start-CMObjectTracking を実行すると、PowerShell ランタイムは Configuration Manager コマンドレットによって作成されたIResultObjectオブジェクトを追跡します。 手動でクリーンアップされていないオブジェクトの場合は、個別のオブジェクトに .Dispose() 対して Disconnect-CMTrackedObject を使用してそれらを再利用します。

オブジェクトを再利用すると、再利用したり、オブジェクト パイプラインを介して別のコマンドレットに渡したりできなくなりました。

Stop-CMObjectTracking を 使用すると、オブジェクト追跡をオフにできます。 以前に割り当てられたオブジェクトはアクティブなままです。

未請求のリソースを使用すると、SMS プロバイダーがクォータ違反エラーを発生する可能性があります。 通常、これらのクォータの問題は、大規模な SMS Provider オブジェクトのセットや長時間実行される環境での操作によって発生します。

注意

この機能は実験的な機能であり、今後のリリースで変更または削除される可能性があります。

Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\> 。 詳細については 、「Getting started」を参照してください。

例

例 1

最初のコマンドは、オブジェクト追跡を有効にします。 2 番目のコマンドは、変数の変数で指定された 1 つのオブジェクト$obj します。 3 番目のコマンドは、追跡対象のすべてのオブジェクトを再利用します。 最後のコマンドは、オブジェクト追跡をオフにします。

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
Accept pipeline input:False
Accept wildcard characters:False
-Confirm

コマンドレットを実行する前に確認を求めるメッセージを表示するには、このパラメーターを追加します。

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

このパラメーターは、ワイルドカード文字をリテラル文字値として扱います。 ForceWildcardHandling と組み合わせは使用できない。

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

確認を求めずにコマンドを実行するには、このパラメーターを追加します。

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

このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。

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

Configuration Manager コマンドレットで以前に作成した IResultObject を指定します。

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

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

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

入力

System.IDisposable[]

出力

System.Object