Compartir a través de

Get-ScheduledJob

  • Referencia
Módulo:
PSScheduledJob

Obtiene los trabajos programados en el equipo local.

Syntax

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

Description

El cmdlet Get-ScheduledJob obtiene los trabajos programados en el equipo local. Get-ScheduledJob solo obtiene trabajos programados creados por el usuario actual mediante el cmdlet Register-ScheduledJob.

Aunque los trabajos que se crean mediante el cmdlet Register-ScheduledJob aparecen en el Programador de tareas, Get-ScheduledJob obtiene solo los trabajos programados, y no las tareas programadas que se crearon mediante el Programador de tareas.

Sin parámetros, Get-ScheduledJob obtiene todos los trabajos programados en el equipo. Se pueden usar los parámetros de Get-ScheduledJob para obtener los trabajos programados por su identificador o nombre y examinarlos o canalizarlos a otros cmdlets.

Get-ScheduledJob es una de una colección de cmdlets de programación de trabajos en el módulo PSScheduledJob que se incluye en Windows PowerShell.

Para más información sobre los trabajos programados, vea los temas Acerca de en el módulo PSScheduledJob. Importe el módulo PSScheduledJob y escriba: Get-Help about_Scheduled* o vea about_Scheduled_Jobs.

Este cmdlet se introdujo en Windows PowerShell 3.0.

Ejemplos

Ejemplo 1: Obtener todos los trabajos programados

PS C:\> Get-ScheduledJob

Este comando obtiene todos los trabajos programados en el equipo local.

Ejemplo 2: Obtención de trabajos programados por nombre

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

Este comando obtiene todos los trabajos programados en el equipo que tienen nombres que incluyen Backup o Archive. Este formato de comando permite buscar trabajos específicos.

Ejemplo 3: Obtener trabajos programados en equipos remotos

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

Este comando obtiene todos los trabajos programados de los equipos recogidos en el archivo Servers.txt. El comando usa el cmdlet Invoke-Command para ejecutar un comando Get-ScheduleJob en cada equipo.

Ejemplo 4: Canalización de trabajos programados a otros cmdlets

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

Este comando obtiene los desencadenadores de trabajo de los trabajos programados DailyBackup y WeeklyBackup. Usa el cmdlet Get-ScheduledJob para obtener los trabajos programados y el cmdlet Get-JobTrigger para obtener los desencadenadores de trabajo de los trabajos programados.

Parámetros

-Id

Obtiene solo los trabajos programados con el número de identificación especificado. Escriba uno o varios identificadores de trabajos programados en el equipo. Get-ScheduledJob obtiene de forma predeterminada todos los trabajos programados en el equipo.

Type:Int32[]
Position:0
Default value:All jobs
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Obtiene solo los trabajos programados con los nombres especificados. Escriba uno o varios nombres de trabajos programados en el equipo. Se admite caracteres comodín. Get-ScheduledJob obtiene de forma predeterminada todos los trabajos programados en el equipo.

Type:String[]
Position:0
Default value:All jobs
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Entradas

None

No se puede canalizar la entrada a Get-ScheduledJob.

Salidas

ScheduledJobDefinition

Notas

  • Cada trabajo programado se guarda en un subdirectorio del directorio $home\AppData\Local\Microsoft\Windows\PowerShell\ScheduledJobs del equipo local. El nombre del subdirectorio se deriva del nombre del trabajo programado y contiene el archivo XML del trabajo programado y de los registros de su historial de ejecución. Para más información sobre los trabajos programados en el disco, consulte about_Scheduled_Jobs_Advanced.
  • Los trabajos programados que se crean en Windows PowerShell aparecen en el Programador de tareas, en la carpeta Task Scheduler Library\Microsoft\Windows\PowerShell\ScheduledJobs. Puede usar el Programador de tareas para ver y editar el trabajo programado.
  • Puede usar el Programador de tareas, la herramienta de línea de comandos SchTasks.exe y los cmdlets del Programador de tareas para administrar los trabajos programados que se crean con cmdlets ScheduledJob. Sin embargo, los cmdlets ScheduledJob no sirven para administrar las tareas que se creen en el Programador de tareas.