Remove-SCServiceConfiguration
VMM ライブラリからサービス構成オブジェクトを削除します。
構文
Remove-SCServiceConfiguration
[-VMMServer <ServerConnection>]
[-ServiceConfiguration] <ServiceConfiguration>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-WhatIf]
[-Confirm]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
説明
Remove-SCServiceConfiguration コマンドレットは、仮想マシン マネージャー (VMM) ライブラリから 1 つ以上のサービス構成オブジェクトを削除します。
例
例 1: ライブラリから特定のサービス構成オブジェクトを削除する
PS C:\> $SvcConfig = Get-SCServiceConfiguration -VMMServer "VMMServer01.Contoso.com" -Name "Service01"
PS C:\> Remove-SCServiceConfiguration -ServiceConfiguration $SvcConfig -Confirm
最初のコマンドは、Service01 という名前のサービス構成オブジェクトを取得し、そのオブジェクトを $SvcConfig 変数に格納します。
2 番目のコマンドは、$SvcConfigに格納されているサービス構成オブジェクトを VMM データベースから削除し、対応するサービス構成オブジェクトと、ライブラリ内の他のすべての関連オブジェクトを削除します。 サービス構成オブジェクトが削除される前に、確認プロンプトが表示されます。
例 2: すべてのサービス構成オブジェクトを削除する
PS C:\> $SvcConfigs = Get-SCServiceConfiguration -VMMServer "VMMServer01.Contoso.com"
PS C:\> $SvcConfigs | Remove-SCServiceConfiguration -Confirm
最初のコマンドは、VMMServer01 上のすべてのサービス構成オブジェクトを取得し、$SvcConfigs変数にオブジェクトを格納します。
2 番目のコマンドは、$SvcConfigsに格納されているすべてのサービス構成オブジェクトを削除し、ライブラリ内の他のすべての関連オブジェクトを削除します。 サービス構成オブジェクトが削除される前に、確認プロンプトが表示されます。
パラメーター
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-JobVariable
ジョブの進行状況を追跡し、このパラメーターによって指定された変数に格納することを指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-OnBehalfOfUser
ユーザー名を指定します。 このコマンドレットは、このパラメーターが指定したユーザーに代わって動作します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-OnBehalfOfUserRole
ユーザー ロールを指定します。 ユーザー ロールを取得するには、Get-SCUserRole コマンドレットを使用します。 このコマンドレットは、このパラメーターが指定するユーザー ロールに代わって動作します。
型: | UserRole |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-PROTipID
このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。
型: | Guid |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-RunAsynchronously
コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ServiceConfiguration
サービス構成オブジェクトを指定します。
型: | ServiceConfiguration |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-VMMServer
VMM サーバー オブジェクトを指定します。
型: | ServerConnection |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |