Get-SCJob

VMM ジョブ オブジェクトを取得します。

構文

Get-SCJob
   [-VMMServer <ServerConnection>]
   [[-Name] <String>]
   [-Full]
   [-Newest <Int32>]
   [-Job <Task>]
   [-ID <Guid>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCJob
   [-VMMServer <ServerConnection>]
   [[-Name] <String>]
   [-Full]
   [-All]
   [-Job <Task>]
   [-ID <Guid>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCJob
   [-VMMServer <ServerConnection>]
   [[-Name] <String>]
   [-Running]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

説明

Get-SCJob コマンドレットは、VMM サーバー上の 1 つ以上の Virtual Machine Manager (VMM) ジョブ オブジェクトを取得します。 ジョブは、VMM 環境でアクションを完了するために順番に実行される一連の手順です。 指定した条件に基づいて、ジョブ オブジェクトを取得できます。

VMM では、一連のジョブをグループ化し、それらをセットとしてまとめて実行できます。 たとえば、テンプレートの作成など、VMM の複雑なアクションには、ジョブ グループと呼ばれる一連のジョブが組み込まれる場合があります。 ジョブ グループの使用方法を示す例については、New-SCVMTemplate、New-SCHardwareProfile、New-SCVirtualDiskDrive、New-SCVirtualDVDDrive、New-SCVirtualMachine、Set-SCVirtualCOMPort のコマンドレットを参照してください。

例 1: 実行中のすべてのジョブを取得する

PS C:\> Get-Job -Running

このコマンドは、実行中のすべてのジョブを取得します。

例 2: 失敗したすべてのジョブを取得する

PS C:\> $VMMJobs = Get-SCJob | where { $_.Status -eq "Failed" } | Format-List -Property Name, ID, Status
PS C:\> $VMMJobs

最初のコマンドは、状態が Failed のすべてのジョブ オブジェクトを取得し、パイプライン 演算子を使用して各オブジェクトを Format-List コマンドレットに渡します。このコマンドレットは、名前、ID、および Status を$VMMJobs変数に格納します。

2 番目のコマンドは、$VMMJobsに格納されている情報をユーザーに表示します (この場合は、実行中の各ジョブの名前、ID、状態)。

例 3: VMM ジョブ オブジェクトの .NET の種類、メソッド、プロパティに関する情報を取得する

PS C:\> Get-SCJob | Get-Member

このコマンドは 、Get-Member コマンドレットを使用して、 Get-SCJob の .NET 型、プロパティ、メソッド、およびイベントを表示します。

パラメーター

-All

このコマンドレットは、親オブジェクトに関係なくすべての下位オブジェクトを取得することを示します。 たとえば、コマンドは、各仮想ディスク ドライブ オブジェクトが関連付けられている仮想マシン オブジェクトまたはテンプレート オブジェクトに関係なく、すべての仮想ディスク ドライブ オブジェクトを取得します Get-SCVirtualDiskDrive -All

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Full

コマンドレットから監査レコードを含むジョブ オブジェクトが返されることを示します。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ID

特定のオブジェクトのグローバル一意識別子 (GUID) として数値識別子を指定します。

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Job

VMM ジョブ オブジェクトを指定します。

Type:Task
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

VMM オブジェクトの名前を指定します。

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Newest

最後に指定した時間数で作成されたすべてのジョブを返すか、指定した数の最新のソフトウェア更新プログラムを返します。

過去 48 時間以内に作成されたすべてのジョブを返す形式の例: Get-SCJob -Newest 48

10 個の最新の更新プログラムを返す形式の例: Get-SCUpdate -Newest 10

Type:Int32
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

-Running

実行中のすべてのジョブが返されることを示します。

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

VMM サーバー オブジェクトを指定します。

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

出力

Job

このコマンドレットは 、Job オブジェクトを返します。