Get-ScheduledJob

モジュール:: PSScheduledJob

ローカルコンピューター上のスケジュールされたジョブを取得します。

構文

Get-ScheduledJob
   [[-Id] <Int32[]>]
   [<CommonParameters>]

Get-ScheduledJob
   [-Name] <String[]>
   [<CommonParameters>]

説明

Get-ScheduledJob コマンドレットは、ローカルコンピューター上のスケジュールされたジョブを取得します。 Get-ScheduledJob は、Register-ScheduledJob コマンドレットを使用して現在のユーザーによって作成されたスケジュールされたジョブのみを取得します。

Register-ScheduledJob コマンドレットを使用して作成されたジョブはタスクスケジューラに表示されますが、Get-ScheduledJob はスケジュールされたジョブのみを取得します。タスクスケジューラで作成されたスケジュールされたタスクは取得されません。

パラメーターを指定しない場合、 Get-ScheduledJob はコンピューター上のすべてのスケジュールされたジョブを取得します。 Get-ScheduledJob のパラメーターを使用して、スケジュールされたジョブを ID または名前で取得し、それらを調べたり、他のコマンドレットにパイプしたりできます。

Get-ScheduledJob は、Windows PowerShell に含まれている PSScheduledJob モジュール内のジョブスケジューリングコマンドレットのコレクションの 1 つです。

スケジュールされたジョブの詳細については、PSScheduledJob モジュールの About トピックを参照してください。 PSScheduledJob モジュールをインポートし、「 Get-Help about_Scheduled* 」と入力するか、「about_Scheduled_Jobs」と入力します。

このコマンドレットは、Windows PowerShell 3.0 で導入されました。

例

例 1: スケジュールされたすべてのジョブを取得する

PS C:\> Get-ScheduledJob

このコマンドは、ローカルコンピューター上のすべてのスケジュールされたジョブを取得します。

例 2: スケジュールされたジョブを名前で取得する

PS C:\> Get-ScheduledJob -Name *Backup*, *Archive*

このコマンドは、Backup または Archive を含む名前を持つコンピューター上のすべてのスケジュールされたジョブを取得します。このコマンド形式を使用すると、特定のジョブを検索できます。

例 3: リモートコンピューターでスケジュールされたジョブを取得する

PS C:\> Invoke-Command -ComputerName (Get-Content Servers.txt) {Get-ScheduledJob}

このコマンドは、Servers.txt ファイルにリストされているコンピューター上のすべてのスケジュールされたジョブを取得します。このコマンドでは、Invoke-Command コマンドレットを使用して、各コンピューターで Get-ScheduleJob コマンドを実行します。

例 4: スケジュールされたジョブを他のコマンドレットにパイプする

PS C:\> Get-ScheduledJob DailyBackup, WeeklyBackup | Get-JobTrigger

このコマンドは、DailyBackup と WeeklyBackup のスケジュールされたジョブのジョブトリガーを取得します。 Get-ScheduledJob コマンドレットを使用してスケジュールされたジョブを取得し、Get-JobTrigger コマンドレットを使用してスケジュールされたジョブのジョブトリガーを取得します。

パラメーター

-Id

指定した ID (ID) を持つスケジュールされたジョブのみを取得します。コンピューター上のスケジュールされたジョブの 1 つ以上の ID を入力します。既定では、 Get-ScheduledJob はコンピューター上のすべてのスケジュールされたジョブを取得します。

型:	Int32[]
配置:	0
規定値:	All jobs
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Name

指定した名前のスケジュールされたジョブのみを取得します。コンピューター上のスケジュールされたジョブの名前を 1 つ以上入力します。ワイルドカードがサポートされています。既定では、 Get-ScheduledJob はコンピューター上のすべてのスケジュールされたジョブを取得します。

型:	String[]
配置:	0
規定値:	All jobs
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

None

入力を Get-ScheduledJob にパイプすることはできません。

出力

ScheduledJobDefinition

メモ

スケジュールされた各ジョブは、ローカルコンピューター上の $home\AppData\Local\Microsoft\Windows\PowerShell\ScheduledJobs ディレクトリのサブディレクトリに保存されます。サブディレクトリには、スケジュールされたジョブの名前が付けられ、スケジュールされたジョブの XML ファイルとその実行履歴のレコードが含まれています。ディスク上のスケジュールされたジョブの詳細については、about_Scheduled_Jobs_Advancedを参照してください。
Windows PowerShell で作成したスケジュールされたジョブは、タスクスケジューラの Task Scheduler Library\Microsoft\Windows\PowerShell\ScheduledJobs フォルダに表示されます。タスクスケジューラを使用して、スケジュールされたジョブを表示および編集できます。
タスクスケジューラ、SchTasks.exe コマンドラインツール、およびタスクスケジューラコマンドレットを使用して、スケジュールされたジョブコマンドレットで作成するスケジュールされたジョブを管理できます。ただし、スケジュールされたジョブコマンドレットを使用して、タスクスケジューラで作成したタスクを管理することはできません。