Dela via

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[]>
   [-Name] <String[]>
   [<CommonParameters>]
Add-JobTrigger
   [-Trigger] <ScheduledJobTrigger[]>
   [-Id] <Int32[]>
   [<CommonParameters>]

Description

Cmdleten Add-JobTrigger lägger till jobbutlösare i 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ångs- eller återkommande schema eller när en händelse inträffar.

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

Om du vill skapa jobbutlösare för värdet för utlösarparametern 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 Om ämnen i modulen PSScheduledJob. Importera PSScheduledJob-modulen och skriv sedan: Get-Help about_Scheduled* eller se about_Scheduled_Jobs.

Denna cmdlet introducerades i Windows PowerShell 3.0.

Exempel

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

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

De här kommandona lägger till utlösaren för det dagliga jobbet i det schemalagda jobbet TestJob.

Det första kommandot använder cmdleten New-JobTrigger för att skapa en jobbutlösare som startar ett schemalagt jobb varje dag kl. 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

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

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

Dessa kommandon kopierar jobbutlösaren från det schemalagda jobbet BackupArchives och lägger till den i de schemalagda jobben 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 de schemalagda jobben TestBackup och BackupLogs.

Parametrar

-Id

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

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

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

-InputObject

Anger schemalagda jobb. 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: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ösare 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 vilka 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:ScheduledJobTrigger[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Indata

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

Du kan skicka jobbutlösare eller schemalagda jobb till Add-JobTrigger.

Utdata

None

Denna cmdlet returnerar inga utdata.