Remove-SCService
VMM サービスと、関連付けられているすべての仮想マシンを削除します。
構文
Remove-SCService
[-VMMServer <ServerConnection>]
[-Service] <Service>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-WhatIf]
[-Confirm]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]説明
Remove-SCService コマンドレットは、仮想マシン マネージャー (VMM) サービスと、展開されているホストから、関連付けられているすべての仮想マシンを削除します。 サービスを削除する前に、サービスが停止状態である必要があります。 サービスを停止するには、Stop-SCService コマンドレットを使用します。
例
例 1: ホストにデプロイされた特定のサービスを削除する
PS C:\> $Service = Get-SCService -VMMServer "VMMServer01.Contoso.com" -Name "Service01"
PS C:\> Stop-SCService -Service $Service
PS C:\> Remove-SCService -Service $Service -Confirm最初のコマンドは、VMMServer01 で Service01 という名前のサービス オブジェクトを取得し、$Service変数にオブジェクトを格納します。
2 番目のコマンドは、$Serviceに格納されているサービスを停止します。
最後のコマンドは、$Serviceに格納されているサービスを削除し、対応する仮想マシン ファイルをファイル システムから削除します。 サービスが削除される前に、確認プロンプトが表示されます。
例 2: 特定の文字列を含む名前を持つすべてのサービスを削除する
PS C:\> $Services = Get-SCService -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -Match "Service" }
PS C:\> $Services | Stop-SCService
PS C:\> $Services | Remove-SCService -Confirm最初のコマンドは、名前に文字列 "Service" を含むすべてのサービス オブジェクトを取得し、そのオブジェクトを $Services 変数に格納します。
2 番目のコマンドは、$Serviceに格納されているすべてのサービスを停止します。
3 番目のコマンドは、$Servicesに含まれるすべてのサービス オブジェクトを削除し、対応する仮想マシン ファイルをファイル システムから削除します。 サービスが削除される前に、確認プロンプトが表示されます。
パラメーター
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
ジョブの進行状況を追跡して、このパラメーターで示す名前の変数に保管するように指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUser
ユーザー名を指定します。 このコマンドレットは、このパラメーターで指定されたユーザーの代わりに動作します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUserRole
ユーザー ロールを指定します。 ユーザー ロールを取得するには、 Get-SCUserRole コマンドレットを 使用します。 このコマンドレットは、このパラメーターが指定するユーザー ロールの代わりに動作します。
| Type: | UserRole |
| 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 |
-Service
VMM サービス オブジェクトを指定します。
| Type: | Service |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMMServer
VMM サーバー オブジェクトを指定します。
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |