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 オブジェクトが必要です。