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-SCJob -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このコマンドでは、
パラメーター
-All
このコマンドレットは、親オブジェクトに依存しないすべての下位オブジェクトを取得することを示します。
たとえば、コマンド Get-SCVirtualDiskDrive -All は、各仮想ディスク ドライブ オブジェクトが関連付けられている仮想マシン オブジェクトまたはテンプレート オブジェクトに関係なく、すべての仮想ディスク ドライブ オブジェクトを取得します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Full
コマンドレットが監査レコードを持つジョブ オブジェクトを返すことを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ID
特定のオブジェクトのグローバル一意識別子 (GUID) として数値識別子を指定します。
| 型: | Guid |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Job
VMM ジョブ オブジェクトを指定します。
| 型: | Task |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Name
VMM オブジェクトの名前を指定します。
| 型: | String |
| 配置: | 0 |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Newest
最後に指定した時間数で作成されたすべてのジョブを返すか、指定した数の最新のソフトウェア更新プログラムを返します。
過去 48 時間以内に作成されたすべてのジョブを返す形式の例: Get-SCJob -Newest 48
| 型: | Int32 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-OnBehalfOfUser
ユーザー名を指定します。 このコマンドレットは、このパラメーターが指定したユーザーに代わって動作します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-OnBehalfOfUserRole
ユーザー ロールを指定します。 ユーザー ロールを取得するには、Get-SCUserRole コマンドレットを使用します。 このコマンドレットは、このパラメーターが指定するユーザー ロールに代わって動作します。
| 型: | UserRole |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Running
実行中のすべてのジョブが返されることを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-VMMServer
VMM サーバー オブジェクトを指定します。
| 型: | ServerConnection |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
出力
Job
このコマンドレットは、Job オブジェクトを返します。