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-4bd0-a999-3fae8cd77177 で識別される VM01 上のジョブのみを選択し、$Job変数に thie オブジェクトを格納します。
2 番目のコマンドはジョブを停止し、停止したジョブ オブジェクトをユーザーに返します。
パラメーター
-Job
VMM ジョブ オブジェクトを指定します。
型: | Task |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-OnBehalfOfUser
ユーザー名を指定します。 このコマンドレットは、このパラメーターが指定したユーザーに代わって動作します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-OnBehalfOfUserRole
ユーザー ロールを指定します。 ユーザー ロールを取得するには、Get-SCUserRole コマンドレットを使用します。 このコマンドレットは、このパラメーターが指定するユーザー ロールに代わって動作します。
型: | UserRole |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
出力
Task
このコマンドレットは、Task オブジェクトを返します。
メモ
- このコマンドレットには、Get-SCJob コマンドレットを使用して取得できる VMM ジョブ オブジェクトが必要です。