Remove-SCGuestOSProfile

モジュール:

VirtualMachineManager

VMM からゲスト オペレーティング システム プロファイル オブジェクトを削除します。

構文

Remove-SCGuestOSProfile
      [-GuestOSProfile] <GuestOSProfile>
      [-Force]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

Remove-SCGuestOSProfile コマンドレットは、VMM ライブラリから 1 つ以上のゲスト オペレーティング システム プロファイル オブジェクトを削除します。

このコマンドレットは、成功した場合 (MarkedForDeletion プロパティが True に設定されている) オブジェクトを返すか、失敗した場合にエラー メッセージを返します。

例

例 1: ライブラリから特定のゲスト オペレーティング システム プロファイルを削除する

PS C:\> $OSProfile = Get-SCGuestOSProfile -Name "NewOSProfile01"
PS C:\> Remove-SCGuestOSProfile -GuestOSProfile $OSProfile -Confirm

最初のコマンドは、NewOSProfile01 という名前のゲスト オペレーティング システム プロファイル オブジェクトを取得し、$OSProfile変数にオブジェクトを格納します。

2 番目のコマンドは、$OSProfileに格納されているゲスト オペレーティング システム プロファイルを削除し、操作を完了する前に確認を求めます。

例 2: 各削除の確認を求められることなく、すべてのオペレーティング システム プロファイルを削除する

PS C:\> $OSProfiles = Get-SCGuestOSProfile -VMMServer "VMMServer01.Contoso.com"
PS C:\> $OSProfiles | Remove-SCGuestOSProfile

最初のコマンドは、VMMServer01 からすべてのオペレーティング システム プロファイル オブジェクトを取得し、$OSProfiles オブジェクト配列にオブジェクトを格納します。

2 番目のコマンドは、$OSProfiles内の各オブジェクトを Remove-OSProfile コマンドレットに渡します。これにより、各ゲスト オペレーティング システム プロファイル オブジェクトが VMM ライブラリから削除されます。

パラメーター

-Confirm

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

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Force

ユーザーの確認を求めずにコマンドを強制的に実行します。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-GuestOSProfile

ゲスト オペレーティング システム プロファイル オブジェクトを指定します。

型:	GuestOSProfile
配置:	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-SCGuestOSProfile コマンドレットを使用して取得できる VMM ゲスト オペレーティング システム プロファイル オブジェクトが必要です。

関連リンク

• Get-SCGuestOSProfile
• New-SCGuestOSProfile
• Set-SCGuestOSProfile