Compartir a través de

Get-ScheduledJobOption

  • Referencia
Módulo:
PSScheduledJob

Obtiene las opciones de trabajo de los trabajos programados.

Syntax

Get-ScheduledJobOption
   [-InputObject] <ScheduledJobDefinition>
   [<CommonParameters>]
Get-ScheduledJobOption
   [-Id] <Int32>
   [<CommonParameters>]
Get-ScheduledJobOption
   [-Name] <String>
   [<CommonParameters>]

Description

El Get-ScheduledJobOption cmdlet obtiene las opciones de trabajo de los trabajos programados. Este comando se puede usar para examinar las opciones de trabajo o para canalizar las opciones del trabajo a otros cmdlets.

Las opciones de trabajo no se guardan en el disco de forma independiente; forman parte de un trabajo programado. Para obtener las opciones de trabajo de un trabajo programado, especifique el trabajo programado en cuestión.

Use los parámetros del Get-ScheduledJobOption cmdlet para identificar el trabajo programado. Puede identificar los trabajos programados por sus nombres o números de identificación, o si escribe o canaliza objetos ScheduledJob , como los devueltos por el Get-ScheduledJob cmdlet, a Get-ScheduledJobOption.

Get-ScheduledJobOption 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 opciones de trabajo

En este ejemplo se obtienen las opciones de trabajo de los trabajos programados que coinciden con un nombre especificado.

Get-ScheduledJobOption -Name "*Backup*"

Ejemplo 2: Obtener todas las opciones de trabajo

En este ejemplo se obtienen las opciones de trabajo de todos los trabajos programados en el equipo local.

Get-ScheduledJob | Get-ScheduledJobOption

En el ejemplo se usa el Get-ScheduledJob cmdlet para obtener los trabajos programados en el equipo local. Un operador de canalización (|) envía los trabajos programados al Get-ScheduledJobOption cmdlet , que obtiene las opciones de trabajo de cada trabajo programado.

Ejemplo 3: Obtener opciones de trabajo seleccionadas

En este ejemplo se muestra cómo encontrar un objeto de opciones de trabajo con valores concretos.

Get-ScheduledJob | Get-ScheduledJobOption | Where {$_.RunElevated -and !$_.WaketoRun}

Get-ScheduledJob | Get-ScheduledJobOption | Where {$_.RunElevated -and !$_.WaketoRun} |
    ForEach-Object {$_.JobDefinition}

El primer comando obtiene las opciones de trabajo en las que la propiedad RunElevated tiene un valor de $True y la propiedad RunWithoutNetwork tiene un valor de $false. La salida muestra el objeto JobOptions seleccionado.

El segundo comando muestra cómo buscar a qué trabajo programado pertenecen las opciones de trabajo. Este comando usa un operador de canalización (|) para enviar las opciones de trabajo seleccionadas al ForEach-Object cmdlet , que obtiene la propiedad JobDefinition de cada objeto de opciones. La propiedad JobDefinition contiene el objeto de trabajo de origen.

Ejemplo 4: Uso de opciones de trabajo para crear un nuevo trabajo

En este ejemplo se muestra cómo usar las opciones de trabajo que Get-ScheduledJobOption se obtienen en un nuevo trabajo programado.

$Opts = Get-ScheduledJobOption -Name "BackupTestLogs"
Register-ScheduledJob -Name "Archive-Scripts" -FilePath "\\Srv01\Scripts\ArchiveScripts.ps1" -ScheduledJobOption $Opts

El primer comando usa Get-ScheduledJobOption para obtener las opciones de trabajos del trabajo programado BackupTestLogs. El comando guarda las opciones en la $Opts variable .

El segundo comando usa Register-ScheduledJob el cmdlet para crear un nuevo trabajo programado. El valor del parámetro ScheduledJobOption es el objeto options de la $Opts variable .

Ejemplo 5: Obtener opciones de trabajo desde un equipo remoto

$O = Invoke-Command -ComputerName "Srv01" -ScriptBlock {Get-ScheduledJob -Name "DataDemon" }

Este comando usa el Invoke-Command cmdlet para obtener las opciones de trabajo programadas del trabajo DataDemon en el equipo Srv01. El comando guarda las opciones en la $O variable .

Parámetros

-Id

Especifica el número de identificación de un trabajo programado. Get-ScheduledJobOption obtiene las opciones de trabajo del trabajo programado especificado.

Para obtener los números de identificación de los trabajos programados en el equipo local o en un equipo remoto, use el Get-ScheduledJob cmdlet .

Type:Int32
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Especifica un trabajo programado Escriba una variable que contenga un objeto ScheduledJob o escriba un comando o expresión que obtenga un objeto ScheduledJob , como un Get-ScheduledJob comando. También puede canalizar un objeto ScheduledJob a Get-ScheduledJobOption.

Type:ScheduledJobDefinition
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Especifica los nombres de los trabajos programados. Get-ScheduledJobOption obtiene las opciones de trabajo del trabajo programado especificado. Se admite caracteres comodín.

Para obtener los nombres de los trabajos programados en el equipo local o en un equipo remoto, use el Get-ScheduledJob cmdlet .

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Entradas

ScheduledJobDefinition

Puede canalizar un objeto de trabajo programado a este cmdlet.

Salidas

ScheduledJobOptions

Este cmdlet devuelve un objeto ScheduledJobOptions .