Remove-SCISO
VMM ライブラリから ISO ファイルを削除します。
構文
Remove-SCISO
[-ISO] <ISO>
[-Force]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Remove-SCISO コマンドレットは、仮想マシン マネージャー (VMM) ライブラリから ISO ファイルを削除し、ライブラリ サーバー上の ISO ファイルを削除します。
ISO が仮想マシン、テンプレート、またはハードウェア プロファイルにアタッチされていて、 Force パラメーターを指定しない場合は、ISO を含むコンテナーが VMM に一覧表示され、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
コマンドレットの実行前に確認を求めるメッセージが表示されます。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
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 |
-ISO
ISO オブジェクトを指定します。
Type: | ISO |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-JobVariable
ジョブの進行状況を追跡して、このパラメーターで示す名前の変数に保管するように指定します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PROTipID
このアクションをトリガーしたパフォーマンスとリソース最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsynchronously
コントロールがコマンド シェルに直ちに戻るように、ジョブが非同期的に実行されることを示します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
メモ
- Get-SCISO コマンドレットを使用して取得できる VMM ISO オブジェクトが必要です。