Stop-SCJob
VMM ジョブの実行を停止します。
構文
Stop-SCJob
[-Job] <Task>
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
説明
Stop-SCJob コマンドレットは、実行中の 1 つ以上の Virtual Machine Manager (VMM) ジョブを停止し、停止状態の各ジョブのオブジェクトを返します。 VMM ジョブが現在実行されていない場合、このコマンドレットは無効です。
例
例 1: 現在実行中のすべてのジョブを停止する
PS C:\> $Job = Get-SCJob | where { $_.Status -eq "Running" }
PS C:\> $Job | Stop-SCJob
最初のコマンドは、すべての VMM ジョブ オブジェクトを取得し、各ジョブ オブジェクトを "where" フィルターに渡して、現在実行中のジョブのみを選択し、$Job オブジェクト配列にオブジェクトを格納します。
2 番目のコマンドは、$Job内の各オブジェクトを Stop-SCJob コマンドレットに渡し、実行中の各ジョブを停止します。
例 2: 特定の実行中のジョブを非同期で停止する
PS C:\> $Job = Get-SCJob | where { $_.ResultName -eq "VM01" -and $_.ID -eq "cb3a0f0a-9fbc-4bd0-a999-3fae8cd77177" }
PS C:\> Stop-SCJob -Job $Job
最初のコマンドは、すべての VMM ジョブ オブジェクトを取得し、結果から、ジョブ ID cb3a0f0a-9fbc-9fbc-4bd0-a999-3fae8cd77177 で識別される VM01 上のジョブのみを選択し、$Job変数に thie オブジェクトを格納します。
2 番目のコマンドは、ジョブを停止し、停止したジョブ オブジェクトをユーザーに返します。
パラメーター
-Job
VMM ジョブ オブジェクトを指定します。
Type: | Task |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
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 |
出力
Task
このコマンドレットは Task オブジェクトを返します。
メモ
- このコマンドレットには、 Get-SCJob コマンドレットを使用して取得できる VMM ジョブ オブジェクトが必要です。