Remove-CimInstance

構文

CimInstanceComputerSet (既定)

Remove-CimInstance
    [-InputObject] <CimInstance>
    [-ResourceUri <Uri>]
    [-ComputerName <String[]>]
    [-OperationTimeoutSec <UInt32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CimInstanceSessionSet

Remove-CimInstance
    [-InputObject] <CimInstance>
    -CimSession <CimSession[]>
    [-ResourceUri <Uri>]
    [-OperationTimeoutSec <UInt32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

QuerySessionSet

Remove-CimInstance
    [[-Namespace] <String>]
    [-Query] <String>
    -CimSession <CimSession[]>
    [-OperationTimeoutSec <UInt32>]
    [-QueryDialect <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

QueryComputerSet

Remove-CimInstance
    [[-Namespace] <String>]
    [-Query] <String>
    [-ComputerName <String[]>]
    [-OperationTimeoutSec <UInt32>]
    [-QueryDialect <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

説明

例

例 1: CIM インスタンスを削除する

PS C:\>Remove-CimInstance -Query 'Select * from Win32_Environment where name LIKE "testvar%"'

例 2: CIM インスタンス オブジェクトを使用して CIM インスタンスを削除する

PS C:\>calc.exe



PS C:\>$var = Get-CimInstance -Query 'Select * from Win32_Process where name LIKE "calc%"'



PS C:\>Remove-CimInstance -InputObject $var

パラメーター

-CimSession

指定した CIM セッションを使用してコマンドを実行します。 CIM セッションを含む変数、または CIM セッションを作成または取得するコマンド (New-CimSession コマンドレットや Get-CimSession コマンドレットなど) を入力します。 詳細については、「about_CimSessions」を参照してください。

パラメーターのプロパティ

パラメーター セット

-ComputerName

CIM 操作を実行するコンピューターの名前を指定します。 完全修飾ドメイン名 (FQDN) または NetBIOS 名を指定できます。

このパラメーターを指定すると、コマンドレットは WsMan プロトコルを使用して、指定されたコンピューターへの一時的なセッションを作成します。

このパラメーターを指定しない場合、コマンドレットはコンポーネント オブジェクト モデル (COM) を使用してローカル コンピューターで操作を実行します。

同じコンピューターで複数の操作が実行されている場合、CIM セッションを使用して接続するとパフォーマンスが向上します。

パラメーターのプロパティ

パラメーター セット

-Confirm

コマンドレットを実行する前に確認を求めるメッセージが表示されます。

パラメーターのプロパティ

パラメーター セット

-InputObject

CIM サーバーから削除する CIM インスタンス オブジェクトを指定します。 注: コマンドレットに渡された入力オブジェクトは変更されませんで、CIM サーバー内のインスタンスのみが削除されます。

パラメーターのプロパティ

パラメーター セット

-Namespace

CIM 操作の名前空間を指定します。

既定の名前空間は root/cimv2 です。 注: PowerShell はローカル WMI サーバーから名前空間の一覧を取得して名前空間の一覧を提供するため、タブ補完を使用して名前空間の一覧を参照できます。

パラメーターのプロパティ

パラメーター セット

-OperationTimeoutSec

コマンドレットがコンピューターからの応答を待機する時間を指定します。

既定では、このパラメーターの値は 0 です。これは、コマンドレットがサーバーの既定のタイムアウト値を使用することを意味します。

OperationTimeoutSec パラメーターが、堅牢な接続再試行タイムアウトの 3 分未満の値に設定されている場合、クライアントが再接続する前にサーバー上の操作がタイムアウトするため、OperationTimeoutSec パラメーターの値を超えるネットワーク 障害は復旧できません。

パラメーターのプロパティ

パラメーター セット

-Query

CIM サーバーで実行するクエリを指定します。 QueryDialect パラメーターを使用して、クエリ言語を指定できます。

指定した値に二重引用符 (")、一重引用符 (')、または円記号 (\) が含まれている場合は、これらの文字の前に円記号 (\) を付けてエスケープする必要があります。 指定した値で WQL LIKE 演算子を使用する場合は、パーセント (%)、アンダースコア (_)、または左角かっこ ([]) の文字を角かっこ ([]) で囲んでエスケープする必要があります。

パラメーターのプロパティ

パラメーター セット

-QueryDialect

Query パラメーターに使用するクエリ言語を指定します。

このパラメーターに指定できる値は、WQL または CQL です。

デフォルト値は WQL です。

パラメーターのプロパティ

パラメーター セット

-ResourceUri

リソースクラスまたはインスタンスの統一リソース識別子 (URI) を指定します。 URI は、コンピューター上のディスクやプロセスなどの特定の種類のリソースを識別するために使用されます。

URI は、プレフィックスとリソースへのパスで構成されます。 例えば次が挙げられます。

• https://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk
• http://intel.com/wbem/wscim/1/amt-schema/1/AMT_GeneralSettings

既定では、このパラメーターを指定しない場合は、DMTF 標準リソース URI http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ が使用され、クラス名が追加されます。

ResourceURI は、WSMan プロトコルを使用して作成された CIM セッション、または WSMan を使用して CIM セッションを作成する ComputerName パラメーターを指定する場合にのみ使用できます。 ComputerName パラメーターを指定せずにこのパラメーターを指定した場合、または DCOM プロトコルを使用して作成された CIM セッションを指定した場合、DCOM プロトコルは ResourceURI パラメーターをサポートしていないため、エラーが発生します。

ResourceUri パラメーターと Filter パラメーターの両方が指定されている場合、Filter パラメーターは無視されます。

パラメーターのプロパティ

パラメーター セット

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

パラメーターのプロパティ

パラメーター セット

CommonParameters

入力

None

出力

None

関連リンク

• New-CimInstance
• Get-CimInstance
• Set-CimInstance