Add-JobTrigger

  • Referens
Modul:
PSScheduledJob

Lägger till jobbutlösare i schemalagda jobb.

Syntax

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

Description

Cmdleten Add-JobTrigger lägger till jobbutlösare till schemalagda jobb. Du kan använda den för att lägga till flera utlösare till flera schemalagda jobb.

En jobbutlösare startar ett schemalagt jobb enligt ett engångsschema eller återkommande schema eller när en händelse inträffar.

Använd utlösarparametern Add-JobTrigger för för att identifiera de jobbutlösare som ska läggas till. Använd parametrarna Namn, ID eller InputObject för för att identifiera det schemalagda jobb som utlösarna läggs till i. Add-JobTrigger

Om du vill skapa jobbutlösare för värdet för parametern Trigger använder du cmdleten New-JobTrigger eller använder en hash-tabell för att ange jobbutlösaren.

Add-JobTrigger är en av en samling cmdletar för jobbschemaläggning i modulen PSScheduledJob som ingår i Windows PowerShell.

Mer information om schemalagda jobb finns i Avsnittet om i modulen PSScheduledJob. Importera modulen PSScheduledJob och skriv sedan: Get-Help about_Scheduled* eller se about_Scheduled_Jobs.

Den här cmdleten introducerades i Windows PowerShell 3.0.

Exempel

Exempel 1: Lägga till en jobbutlösare i ett schemalagt jobb

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

Dessa kommandon lägger till utlösaren för det dagliga jobbet i det schemalagda testjobbet.

Det första kommandot använder cmdleten New-JobTrigger för att skapa en jobbutlösare som startar ett schemalagt jobb varje dag klockan 03:00. Kommandot sparar jobbutlösaren i variabeln $Daily .

Det andra kommandot använder cmdleten Add-JobTrigger för att lägga till jobbutlösaren i variabeln $Startup till det schemalagda jobbet TestJob.

Exempel 2: Lägga till en jobbutlösare i flera schemalagda jobb

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

Det här kommandot lägger till en AtStartup-jobbutlösare till alla schemalagda jobb på den lokala datorn. Den använder Get-ScheduledJob för att hämta alla schemalagda jobb på datorn. Den använder en pipelineoperator (|) för att skicka jobben till cmdleten Add-JobTrigger , vilket lägger till jobbutlösaren till vart och ett av de schemalagda jobben. Värdet för utlösarparametern är ett New-JobTrigger kommando som skapar utlösaren för AtStartup-jobbet.

Exempel 3: Kopiera en jobbutlösare

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

Dessa kommandon kopierar jobbutlösaren från det schemalagda jobbet BackupArchives och lägger till den i schemalagda jobb för TestBackup och BackupLogs.

Det första kommandot använder cmdleten Get-JobTrigger för att hämta jobbutlösaren för det schemalagda jobbet BackupArchives. Kommandot sparar utlösaren i variabeln $t.

Det andra kommandot använder cmdleten Add-JobTrigger för att lägga till jobbutlösaren i $t till schemalagda jobb för TestBackup och BackupLogs.

Parametrar

-Id

Anger ID-nummer för de schemalagda jobben. Add-JobTrigger lägger till jobbutlösaren till de angivna schemalagda jobben.

Använd cmdleten Get-ScheduledJob för att hämta identifieringsnumret för schemalagda jobb på den lokala datorn eller en fjärrdator.

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

-InputObject

Anger de schemalagda jobben. Ange en variabel som innehåller ScheduledJob-objekt eller skriv ett kommando eller uttryck som hämtar ScheduledJob-objekt , till exempel ett Get-ScheduledJob kommando. Du kan också skicka ScheduledJob-objekt till Add-JobTrigger.

Type:Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Anger namnen på de schemalagda jobben. Add-JobTrigger lägger till jobbutlösarna till de angivna schemalagda jobben. Jokertecken stöds.

Om du vill hämta namnen på schemalagda jobb på den lokala datorn eller en fjärrdator använder du cmdleten Get-ScheduledJob .

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

-Trigger

Anger de jobbutlösare som ska läggas till. Ange en hash-tabell som anger jobbutlösare eller en variabel som innehåller ScheduledJobTrigger-objekt , eller skriv ett kommando eller uttryck som hämtar ScheduledJobTrigger-objekt , till exempel ett Get-JobTrigger kommando. Du kan också skicka ScheduledJobTrigger-objekt till Add-JobTrigger.

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

Indata

Microsoft.PowerShell.ScheduledJob.ScheduledJobTrigger

Du kan skicka en jobbutlösare till den här cmdleten.

Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

Du kan skicka ett schemalagt jobb till den här cmdleten.

Utdata

None

Den här cmdleten returnerar inga utdata.