Remove-CimInstance
CIM インスタンスをコンピューターから削除します。
構文
Remove-CimInstance
[-ResourceUri <Uri>]
[-ComputerName <String[]>]
[-OperationTimeoutSec <UInt32>]
[-InputObject] <CimInstance>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CimInstance
-CimSession <CimSession[]>
[-ResourceUri <Uri>]
[-OperationTimeoutSec <UInt32>]
[-InputObject] <CimInstance>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CimInstance
-CimSession <CimSession[]>
[[-Namespace] <String>]
[-OperationTimeoutSec <UInt32>]
[-Query] <String>
[-QueryDialect <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CimInstance
[-ComputerName <String[]>]
[[-Namespace] <String>]
[-OperationTimeoutSec <UInt32>]
[-Query] <String>
[-QueryDialect <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
このコマンドレットは、Windows プラットフォームでのみ使用できます。
このコマンドレットは、CIM サーバーから CIM インスタンスを削除します。 削除する CIM インスタンスを指定するには、 Get-CimInstance
コマンドレットによって取得された CIM インスタンス オブジェクトを使用するか、クエリを指定します。
InputObject パラメーターが指定されていない場合、コマンドレットは次のいずれかの方法で動作します。
- ComputerName パラメーターも CimSession パラメーターも指定されていない場合、このコマンドレットはコンポーネント オブジェクト モデル (COM) セッションを使用してローカル Windows Management Instrumentation (WMI) で動作します。
- ComputerName パラメーターまたは CimSession パラメーターが指定されている場合、このコマンドレットは、ComputerName パラメーターまたは CimSession パラメーターで指定された CIM サーバーに対して動作します。
例
例 1: CIM インスタンスを削除する
この例では、Query パラメーターを使用して、文字列 testvar で始まる Win32_Environment という名前のクラスから CIM インスタンスを削除します。
Remove-CimInstance -Query 'Select * from Win32_Environment where name LIKE "testvar%"'
例 2: CIM インスタンス オブジェクトを使用して CIM インスタンスを削除する
この例では、Query パラメーターでフィルター処理された CIM インスタンス オブジェクトを取得し、Get-CimInstance
コマンドレットを使用して $var
という名前の変数に格納します。 その後、変数の内容が Remove-CimInstance
コマンドレットに渡され、CIM インスタンスが削除されます。
notepad.exe
$var = Get-CimInstance -Query 'Select * from Win32_Process where name LIKE "notepad%"'
Remove-CimInstance -InputObject $var
パラメーター
-CimSession
指定した CIM セッションを使用してコマンドを実行します。 CIM セッションを含む変数、または CIM セッションを作成または取得するコマンド ( New-CimSession
、 Get-CimSession
コマンドレットなど) を入力します。 詳細については、「 about_CimSession」を参照してください。
型: | CimSession[] |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ComputerName
CIM 操作を実行するコンピューターの名前を指定します。 完全修飾ドメイン名 (FQDN) または NetBIOS 名を指定できます。
このパラメーターを指定すると、コマンドレットは WsMan プロトコルを使用して、指定されたコンピューターへの一時的なセッションを作成します。
このパラメーターを指定しない場合、コマンドレットはコンポーネント オブジェクト モデル (COM) を使用してローカル コンピューターで操作を実行します。
同じコンピューターで複数の操作が実行されている場合、CIM セッションを使用して接続するとパフォーマンスが向上します。
型: | String[] |
Aliases: | CN, ServerName |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-InputObject
CIM サーバーから削除する CIM インスタンス オブジェクトを指定します。 コマンドレットに渡されたオブジェクトは変更されず、CIM サーバー内のインスタンスのみが削除されます。
InputObject パラメーターはコレクションを列挙しません。 コレクションが渡されると、エラーがスローされます。 コレクションを操作する場合は、入力をパイプして値を列挙します。
型: | CimInstance |
Aliases: | CimInstance |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Namespace
CIM 操作の名前空間を指定します。 既定の名前空間は root/cimv2
です。 PowerShell はローカル WMI サーバーから名前空間の一覧を取得して名前空間の一覧を提供するため、タブ補完を使用して名前空間の一覧を参照できます。
型: | String |
配置: | 2 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-OperationTimeoutSec
コマンドレットがコンピューターからの応答を待機する時間を指定します。 既定では、このパラメーターの値は 0
です。これは、コマンドレットがサーバーの既定のタイムアウト値を使用することを意味します。
OperationTimeoutSecパラメーターが堅牢な接続再試行タイムアウト 3 分未満の値に設定されている場合、クライアントが再接続する前にサーバーでの操作がタイムアウトするため、OperationTimeoutSec パラメーターの値を超えるネットワーク障害は復旧できません。
型: | UInt32 |
Aliases: | OT |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Query
CIM サーバーで実行するクエリを指定します。 クエリ言語は、 QueryDialect パラメーターを使用して指定できます。
指定した値に二重引用符 ("
)、単一引用符 ('
)、または円記号 (\
) が含まれている場合は、それらの文字の前に円記号 (\
) を付けてエスケープする必要があります。 指定した値で WQL LIKE
演算子を使用する場合は、次の文字を角かっこ ([]
) で囲んでエスケープする必要があります。パーセント (%
)、アンダースコア (_
)、または角かっこ ([
)。
型: | String |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-QueryDialect
Query パラメーターに使用するクエリ言語を指定します。 このパラメーターに使用できる値は、 WQL
または CQL
です。 既定値は WQL
です。
型: | String |
配置: | Named |
規定値: | WQL |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ResourceUri
リソース クラスまたはインスタンスのリソース Uniform Resource Identifier (URI) を指定します。 URI は、ディスクやプロセスなど、コンピューター上の特定の種類のリソースを特定するために使用されます。
URI は、プレフィックスとリソースのパスで構成されます。 次に例を示します。
http://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 パラメーターは無視されます。
型: | Uri |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
None
このコマンドレットにオブジェクトをパイプすることはできません。
出力
None
このコマンドレットは、出力を返しません。
メモ
PowerShell には、 Remove-CimInstance
の次のエイリアスが含まれています。
- Windows:
rcim
このコマンドレットは、Windows プラットフォームでのみ使用できます。
関連リンク
PowerShell