Remove-SCISO
VMM ライブラリから ISO ファイルを削除します。
構文
Remove-SCISO
[-ISO] <ISO>
[-Force]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Remove-SCISO コマンドレットは、Virtual Machine Manager (VMM) ライブラリから ISO ファイルを削除し、ライブラリ サーバー上の ISO ファイルを削除します。
ISO が仮想マシン、テンプレート、またはハードウェア プロファイルにアタッチされていて、Force パラメーターを指定しない場合は、ISO を含むコンテナーが一覧表示され、ISO を削除するかどうかを確認するメッセージが表示されます。
[はい] と応答すると、VMM は ISO とそれがアタッチされているコンテナーの間の関連付けを削除し、VMM から ISO オブジェクトを削除します。
「いいえ」と返信すると、操作は取り消されます。
このコマンドレットは、成功した場合 (MarkedForDeletion プロパティを $True に設定して) オブジェクトを返すか、失敗した場合にエラー メッセージを返します。
例
例 1: ISO オブジェクトを削除し、対応する.iso ファイルを削除する
PS C:\> $ISO = Get-SCISO -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -eq "OsISO.iso" -and $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" }
PS C:\> Remove-SCISO -ISO $ISO
最初のコマンドは、LibraryServer01 から OsISO.iso という名前の ISO オブジェクトを取得し、$ISO変数に ISO オブジェクトを格納します。
2 番目のコマンドは、ライブラリから ISO オブジェクトを削除し、対応する.iso ファイルをライブラリ サーバー上のファイル システムから削除します。
例 2: ライブラリから複数の ISO オブジェクトを削除する
PS C:\> $ISOs = Get-SCISO -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -match "OsISO" }
PS C:\> $ISOs | Remove-SCISO
最初のコマンドは、名前に文字列 "OsISO" が含まれるすべての ISO オブジェクトを取得し、これらの ISO オブジェクトを$ISOs変数に格納します。
2 番目のコマンドは、$ISOs内の各 ISO オブジェクトを Remove-SCISO コマンドレットに渡します。これにより、各 ISO オブジェクトがライブラリから削除され、対応する.iso ファイルがライブラリ サーバー上のファイル システムから削除されます。
パラメーター
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Force
ユーザーの確認を求めずにコマンドを強制的に実行します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ISO
ISO オブジェクトを指定します。
型: | ISO |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-JobVariable
ジョブの進行状況を追跡し、このパラメーターによって指定された変数に格納することを指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-PROTipID
このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。
型: | Guid |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-RunAsynchronously
コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
メモ
- Get-SCISO コマンドレットを使用して取得できる VMM ISO オブジェクトが必要です。