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