Disconnect-CMTrackedObject

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

SMS プロバイダー クォータ違反エラーを回避するために、使用されていない PowerShell オブジェクトをクリーンアップします。

構文

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 プロバイダー オブジェクトのセットの操作や実行時間の長い環境で発生します。

注:

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

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

例

例 1

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

Start-CMObjectTracking

# Reclaim a single tracked object
$obj | Disconnect-CMTrackedObject -Force

# Reclaim all tracked objects
Disconnect-CMTrackedObject -All

Stop-CMObjectTracking

パラメーター

-All

追跡対象のすべてのオブジェクトを解放するには、このパラメーターを追加します。

型:SwitchParameter
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Confirm

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

型:SwitchParameter
Aliases:cf
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DisableWildcardHandling

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

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Force

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

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-InputObject

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

型:IDisposable[]
Aliases:InputObjects
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-WhatIf

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

型:SwitchParameter
Aliases:wi
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

System.IDisposable[]

出力

System.Object