Find-SCJob

  • リファレンス
モジュール:
VirtualMachineManager

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