Stop-SCJob

  • リファレンス
モジュール:
VirtualMachineManager

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 ジョブ オブジェクトを指定します。

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 ジョブ オブジェクトが必要です。