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 コマンドレットに渡します。このコマンドレットでは、$VMMJobs変数に名前、ID、および Status が格納されます。
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 オブジェクトを返します。