Start-CMObjectTracking

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

PowerShell によって使用される SMS プロバイダー オブジェクトの追跡を開始して、それらを再利用します。

構文

Start-CMObjectTracking
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

説明

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

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

# Reclaim all tracked objects
Disconnect-CMTrackedObject -All

Stop-CMObjectTracking

パラメーター

-Confirm

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

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

-DisableWildcardHandling

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

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

-ForceWildcardHandling

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

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

-WhatIf

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

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

入力

None

出力

System.Object