Find-SCJob
VMM ジョブを検索します。
構文
Find-SCJob
[-After <DateTime>]
[-VMMServer <ServerConnection>]
-MaxCount <Int32>
[-ObjectID <Guid>]
[-CriticalFailures <Boolean>]
[<CommonParameters>]
Find-SCJob
[-VMMServer <ServerConnection>]
-MaxCount <Int32>
[-ObjectID <Guid>]
[-CriticalFailures <Boolean>]
[-Recent]
[<CommonParameters>]
説明
Find-SCJob コマンドレットは、Virtual Machine Manager (VMM) ジョブを検索します。 最新のジョブ、特定の日付以降のジョブを検索したり、結果またはターゲット ID でジョブを検索したりできます。
例
例 1: 過去 5 時間のすべてのジョブを検索する
PS C:\> $StartTime = (Get-Date) - (New-TimeSpan -Hours 5)
PS C:\> Find-SCJob -MaxCount 25 -After $StartTime
このコマンドは、過去 5 時間以内に開始されたすべてのジョブを検索します。 MaxCount パラメーター値は 25 に設定されているため、25 個のジョブ オブジェクトのみが表示されます。
例 2: 最近のジョブを検索する
PS C:\> Find-SCJob -MaxCount 50 -Recent
このコマンドは、最近のジョブを検索し、最新の 50 個のジョブを表示します。
例 3: ObjectID でジョブを検索する
PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> Find-SCJob -MaxCount 10 -ObjectID $VM.Id
最初のコマンドは、VM01 という名前の仮想マシン オブジェクトを取得し、そのオブジェクトを $VM 変数に格納します。
2 番目のコマンドは、指定された仮想マシン ID に対して最大 10 個のジョブを返します。
パラメーター
-After
ジョブの取得後の時刻の DateTime オブジェクトを指定します。 既定では、時刻はローカル タイム ゾーンで表されます。 標準化された時刻の 場合、DateTime オブジェクトを UTC として渡すことができます。
このパラメーターを指定すると、ジョブは StartTime プロパティによってフィルター処理され、最も早い開始時刻から最新の開始時刻に返されます。
DateTime オブジェクトを取得する方法については、Get-Date コマンドレットを参照してください。
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CriticalFailures
重大なエラーのみを検出するかどうかを示します。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaxCount
返すジョブの最大数を指定します。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ObjectID
サービスの GUID としてオブジェクト ID を指定します。 この ID は、返されたジョブの結果オブジェクトまたはターゲット オブジェクトです。
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Recent
最新のジョブが返されることを示します。 ジョブは、最新の開始時刻から最も早い開始時刻に返されます。
このパラメーターを MaxCount パラメーターと共に使用して、指定した数のジョブのみを取得します。
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 オブジェクトを返します。