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

注:

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

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

例

例 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

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

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

-Confirm

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

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 コマンドレットを使用して、以前に作成したすべての IResultObject を指定します。

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

-WhatIf

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

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

入力

System.IDisposable[]

出力

System.Object

関連リンク

• Start-CMObjectTracking
• Stop-CMObjectTracking