次の方法で共有

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 モジュールの概要トピックを参照してください。 PSScheduledJob モジュールをインポートし、「 Get-Help about_Scheduled* 」と入力するか、 about_Scheduled_Jobsを参照してください。

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

例

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

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

Get-ScheduledJob

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

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

Get-ScheduledJob -Name *Backup*, *Archive*

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

この例では、テキスト ファイルに一覧表示されているコンピューター上のすべてのスケジュールされたジョブを取得します。

Invoke-Command -ComputerName (Get-Content Servers.txt) {Get-ScheduledJob}

このコマンドでは、 Invoke-Command コマンドレットを使用して、各コンピューターで Get-ScheduleJob コマンドを実行します。

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

この例では、指定されたスケジュールされたジョブのジョブ トリガーを取得します

Get-ScheduledJob DailyBackup, WeeklyBackup | Get-JobTrigger

Get-ScheduledJob コマンドレットを使用してスケジュールされたジョブを取得し、それらを Get-JobTrigger コマンドレットにパイプして、スケジュールされたジョブのジョブ トリガーを取得します。

パラメーター

-Id

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

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

-Name

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

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

入力

None

このコマンドレットにオブジェクトをパイプすることはできません。

出力

ScheduledJobDefinition

このコマンドレットは、スケジュールされたジョブの定義を返します。

メモ

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