Condividi tramite

Add-JobTrigger

  • Riferimento
Modulo:
PSScheduledJob

Aggiunge trigger di processo ai processi pianificati.

Sintassi

Add-JobTrigger
   [-Trigger] <ScheduledJobTrigger[]>
   [-InputObject] <ScheduledJobDefinition[]>
   [<CommonParameters>]
Add-JobTrigger
   [-Trigger] <ScheduledJobTrigger[]>
   [-Id] <Int32[]>
   [<CommonParameters>]
Add-JobTrigger
   [-Trigger] <ScheduledJobTrigger[]>
   [-Name] <String[]>
   [<CommonParameters>]

Descrizione

Il cmdlet Add-JobTrigger aggiunge trigger di processo ai processi pianificati. È possibile usarlo per aggiungere più trigger a più processi pianificati.

Un trigger di processo avvia un processo pianificato in base a una pianificazione occasionale o ricorrente o quando si verifica un evento.

Usare il parametro trigger di Add-JobTrigger per identificare i trigger di processo da aggiungere. Usare il Name, IDo i parametri inputObject di Add-JobTrigger per identificare il processo pianificato a cui vengono aggiunti i trigger.

Per creare trigger di processo per il valore del parametro Trigger, usare il cmdlet New-JobTrigger o usare una tabella hash per specificare il trigger di processo.

Add-JobTrigger è una raccolta di cmdlet di pianificazione dei processi nel modulo di PSScheduledJob incluso in Windows PowerShell.

Per altre informazioni sui processi pianificati, vedere gli argomenti About nel modulo PSScheduledJob. Importare il modulo PSScheduledJob e quindi digitare: Get-Help about_Scheduled* o vedere about_Scheduled_Jobs.

Questo cmdlet è stato introdotto in Windows PowerShell 3.0.

Esempio

Esempio 1: Aggiungere un trigger di processo a un processo pianificato

$Daily = New-JobTrigger -Daily -At 3AMPS
Add-JobTrigger -Trigger $Daily -Name "TestJob"

Questi comandi aggiungono il trigger processo giornaliero al processo pianificato TestJob.

Il primo comando usa il cmdlet New-JobTrigger per creare un trigger di processo che avvia un processo pianificato ogni giorno alle 3:00. Il comando salva il trigger del processo nella variabile $Daily.

Il secondo comando usa il cmdlet Add-JobTrigger per aggiungere il trigger di processo nella variabile $Startup al processo pianificato TestJob.

Esempio 2: Aggiungere un trigger di processo a diversi processi pianificati

Get-ScheduledJob | Add-JobTrigger -Trigger (New-JobTrigger -AtStartup)

Questo comando aggiunge un trigger di processo AtStartup a tutti i processi pianificati nel computer locale. Usa il Get-ScheduledJob per ottenere tutti i processi pianificati nel computer. Usa un operatore pipeline (|) per inviare i processi al cmdlet Add-JobTrigger, che aggiunge il trigger di processo a ognuno dei processi pianificati. Il valore del parametro trigger è un comando New-JobTrigger che crea il trigger del processo AtStartup.

Esempio 3: Copiare un trigger di processo

$T = Get-JobTrigger -Name "BackupArchives"
Add-JobTrigger -Name "TestBackup,BackupLogs" -Trigger $T

Questi comandi copiano il trigger del processo dal processo pianificato BackupArchives e lo aggiungono ai processi pianificati TestBackup e BackupLogs.

Il primo comando usa il cmdlet Get-JobTrigger per ottenere il trigger di processo del processo pianificato BackupArchives. Il comando salva il trigger nella variabile $t.

Il secondo comando usa il cmdlet Add-JobTrigger per aggiungere il trigger di processo in $t ai processi pianificati TestBackup e BackupLogs.

Parametri

-Id

Specifica i numeri di identificazione dei processi pianificati. Add-JobTrigger aggiunge il trigger di processo ai processi pianificati specificati.

Per ottenere il numero di identificazione dei processi pianificati nel computer locale o in un computer remoto, usare il cmdlet Get-ScheduledJob.

Tipo:Int32[]
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Specifica i processi pianificati. Immettere una variabile contenente oggetti ScheduledJob o digitare un comando o un'espressione che ottiene oggetti ScheduledJob, ad esempio un comando Get-ScheduledJob. È anche possibile inviare tramite pipe oggetti ScheduledJob a Add-JobTrigger.

Tipo:ScheduledJobDefinition[]
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Specifica i nomi dei processi pianificati. Add-JobTrigger aggiunge i trigger di processo ai processi pianificati specificati. Sono supportati caratteri jolly.

Per ottenere i nomi dei processi pianificati nel computer locale o in un computer remoto, usare il cmdlet Get-ScheduledJob.

Tipo:String[]
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Trigger

Specifica i trigger di processo da aggiungere. Immettere una tabella hash che specifica i trigger di processo o una variabile contenente oggetti ScheduledJobTrigger oppure digitare un comando o un'espressione che ottiene oggetti ScheduledJobTrigger, ad esempio un comando Get-JobTrigger. È anche possibile inviare tramite pipe oggetti ScheduledJobTrigger a Add-JobTrigger.

Tipo:ScheduledJobTrigger[]
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Input

ScheduledJobTrigger

È possibile inviare tramite pipe un trigger di processo a questo cmdlet.

ScheduledJobDefinition

È possibile inviare tramite pipe un processo pianificato a questo cmdlet.

Output

None

Questo cmdlet non restituisce alcun output.