Condividi tramite

Add-JobTrigger

  • Riferimento
Modulo:
PSScheduledJob

Aggiunge i trigger di processo ai processi pianificati.

Sintassi

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

Descrizione

Il cmdlet Add-JobTrigger aggiunge i 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 i parametri Name, ID o 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 del processo.

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

Per altre informazioni sui lavori pianificati, vedere gli argomenti Informazioni 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

PS C:\> $Daily = New-JobTrigger -Daily -At 3AMPS
PS C:\> Add-JobTrigger -Trigger $Daily -Name "TestJob"

Questi comandi aggiungono il trigger di 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 19: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

PS C:\> 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 ciascuno 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

PS C:\> $T = Get-JobTrigger -Name "BackupArchives"
PS C:\> Add-JobTrigger -Name "TestBackup,BackupLogs" -Trigger $T

Questi comandi copiano il trigger di 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.

Type:Int32[]
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:ScheduledJobDefinition[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

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

-Trigger

Specifica i trigger di processo da aggiungere. Immettere una tabella hash che specifica i trigger di processo o una variabile che contiene 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.

Type:ScheduledJobTrigger[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Input

Microsoft.PowerShell.ScheduledJob.ScheduledJobTrigger, Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

È possibile inviare tramite pipe i trigger di processo o i processi pianificati a Add-JobTrigger.

Output

None

Questo cmdlet non restituisce alcun output.