Compartir a través de

Get-ScheduledJob

  • Referencia
Módulo:
PSScheduledJob

Obtiene los trabajos programados en el equipo local.

Sintaxis

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

Description

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

Aunque los trabajos creados mediante el Register-ScheduledJob cmdlet aparecen en el Programador de tareas, Get-ScheduledJob solo obtiene 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. Puede usar los parámetros de Get-ScheduledJob para obtener trabajos programados por 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

En este ejemplo se obtienen todos los trabajos programados en el equipo local.

Get-ScheduledJob

Ejemplo 2: Obtener trabajos programados por nombre

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

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

Ejemplo 3: Obtener trabajos programados en equipos remotos

En este ejemplo se obtienen todos los trabajos programados en los equipos que aparecen en un archivo de texto.

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

El comando usa el Invoke-Command cmdlet para ejecutar un Get-ScheduleJob comando en cada equipo.

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

En este ejemplo se obtienen los desencadenadores de trabajo de los trabajos programados especificados.

Get-ScheduledJob DailyBackup, WeeklyBackup | Get-JobTrigger

Usa el Get-ScheduledJob cmdlet para obtener los trabajos programados y canalizalos al Get-JobTrigger cmdlet 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. De forma predeterminada, Get-ScheduledJob obtiene todos los trabajos programados en el equipo.

Tipo:Int32[]
Posición:0
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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. De forma predeterminada, Get-ScheduledJob obtiene todos los trabajos programados en el equipo.

Tipo:String[]
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

None

No se pueden canalizar objetos a este cmdlet.

Salidas

ScheduledJobDefinition

Este cmdlet devuelve la definición de un trabajo programado.

Notas

  • Cada trabajo programado se guarda en un subdirectorio del $HOME\AppData\Local\Microsoft\Windows\PowerShell\ScheduledJobs directorio en el 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 obtener más información sobre los trabajos programados en el disco, consulte about_Scheduled_Jobs_Advanced.
  • Los trabajos programados que cree en Windows PowerShell aparecen en el Programador de tareas en la carpeta Programador de Library\Microsoft\Windows\PowerShell\ScheduledJobs tareas. Puede usar el Programador de tareas para ver y editar el trabajo programado.
  • Puede usar el Programador de tareas, la SchTasks.exe herramienta de línea de comandos y los cmdlets del Programador de tareas para administrar los trabajos programados que cree con los cmdlets trabajo programados. Sin embargo, los cmdlets ScheduledJob no sirven para administrar las tareas que se creen en el Programador de tareas.