Get-ScheduledJob
ローカル コンピューター上のスケジュールされたジョブを取得します。
構文
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*
a0/>」と入力するか、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
コンピューター上のすべてのスケジュールされたジョブを取得します。
Type: | Int32[] |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
指定された名前のスケジュールされたジョブのみを取得します。 コンピューター上のスケジュールされたジョブの 1 つまたは複数の名前を入力します。 ワイルドカードを利用できます。 既定では、 Get-ScheduledJob
コンピューター上のすべてのスケジュールされたジョブを取得します。
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
入力
None
このコマンドレットにオブジェクトをパイプすることはできません。
出力
このコマンドレットは、スケジュールされたジョブの定義を返します。
メモ
- スケジュールされた各ジョブは、ローカル コンピューター上のディレクトリの
$HOME\AppData\Local\Microsoft\Windows\PowerShell\ScheduledJobs
サブディレクトリに保存されます。 サブディレクトリには、スケジュールされたジョブの名前が付けられ、スケジュールされたジョブの XML ファイルとその実行履歴のレコードが含まれます。 ディスク上のスケジュールされたジョブの詳細については、「about_Scheduled_Jobs_Advanced」を参照してください。 - Windows PowerShell で作成したスケジュールされたジョブは、タスク スケジューラ フォルダーのタスク スケジューラ
Library\Microsoft\Windows\PowerShell\ScheduledJobs
に表示されます。 タスク スケジューラを使用して、スケジュールされたジョブを表示および編集できます。 - タスク スケジューラ、コマンド ライン ツール、
SchTasks.exe
およびタスク スケジューラ コマンドレットを使用して、スケジュールされたジョブ コマンドレットを使用して作成するスケジュールされたジョブを管理できます。 ただし、タスク スケジューラで作成したタスクは、スケジュールされたジョブ コマンドレットを使用して管理することはできません。
関連リンク
- Add-JobTrigger
- Disable-JobTrigger
- Disable-ScheduledJob
- Enable-JobTrigger
- Enable-ScheduledJob
- Get-JobTrigger
- Get-ScheduledJob
- Get-ScheduledJobOption
- New-JobTrigger
- New-ScheduledJobOption
- Register-ScheduledJob
- Remove-JobTrigger
- Set-JobTrigger
- Set-ScheduledJob
- Set-ScheduledJobOption
- Unregister-ScheduledJob
PowerShell
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示