Share via

Add-JobTrigger

  • Reference
Modul:
PSScheduledJob

Přidá triggery úloh do plánovaných úloh.

Syntax

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

Description

Rutina Add-JobTrigger přidá triggery úloh do plánovaných úloh. Můžete ho použít k přidání více aktivačních událostí do více naplánovaných úloh.

Trigger úlohy spustí naplánovanou úlohu podle jednorázového nebo opakovaného plánu nebo při výskytu události.

Pomocí parametru Trigger rutiny Add-JobTrigger identifikujte triggery úloh, které se mají přidat. Pomocí parametrů Name, ID nebo InputObject rutiny Add-JobTrigger identifikujte naplánovanou úlohu, do které se triggery přidají.

Pokud chcete vytvořit triggery úloh pro hodnotu parametru Trigger , použijte rutinu New-JobTrigger nebo k určení triggeru úlohy použijte tabulku hash.

Add-JobTrigger je jednou z kolekcí rutin plánování úloh v modulu PSScheduledJob, který je součástí Windows PowerShell.

Další informace o naplánovaných úlohách najdete v tématech O produktu v modulu PSScheduledJob. Importujte modul PSScheduledJob a zadejte: Get-Help about_Scheduled* nebo se podívejte about_Scheduled_Jobs.

Tato rutina byla zavedena v Windows PowerShell 3.0.

Příklady

Příklad 1: Přidání triggeru úlohy do naplánované úlohy

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

Tyto příkazy přidají trigger denní úlohy do naplánované úlohy TestJob.

První příkaz pomocí rutiny New-JobTrigger vytvoří trigger úlohy, který spustí naplánovanou úlohu každý den ve 3:00. Příkaz uloží trigger úlohy do proměnné $Daily.

Druhý příkaz používá rutinu Add-JobTrigger k přidání triggeru úlohy v proměnné $Startup do naplánované úlohy TestJob.

Příklad 2: Přidání triggeru úlohy do několika naplánovaných úloh

PS C:\> Get-ScheduledJob | Add-JobTrigger -Trigger (New-JobTrigger -AtStartup)

Tento příkaz přidá trigger úlohy AtStartup do všech naplánovaných úloh v místním počítači. Používá Get-ScheduledJob k získání všech naplánovaných úloh v počítači. Pomocí operátoru kanálu (|) odešle úlohy do rutiny Add-JobTrigger , která přidá trigger úlohy do každé z naplánovaných úloh. Hodnota parametru Trigger je New-JobTrigger příkaz, který vytvoří trigger úlohy AtStartup.

Příklad 3: Kopírování triggeru úlohy

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

Tyto příkazy zkopírují trigger úlohy z naplánované úlohy BackupArchives a přidají ho do naplánovaných úloh TestBackup a BackupLogs.

První příkaz použije rutinu Get-JobTrigger k získání triggeru úlohy naplánované úlohy BackupArchives. Příkaz uloží trigger do proměnné $t.

Druhý příkaz používá rutinu Add-JobTrigger k přidání triggeru úlohy v $t do naplánovaných úloh TestBackup a BackupLogs.

Parametry

-Id

Určuje identifikační čísla naplánovaných úloh. Add-JobTrigger přidá trigger úlohy do zadaných naplánovaných úloh.

Pokud chcete získat identifikační počet naplánovaných úloh v místním nebo vzdáleném počítači, použijte rutinu Get-ScheduledJob.

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

-InputObject

Určuje naplánované úlohy. Zadejte proměnnou, která obsahuje objekty ScheduledJob , nebo zadejte příkaz nebo výraz, který získá objekty ScheduledJob , například Get-ScheduledJob příkaz. Objekty ScheduledJob můžete také předvést do Add-JobTrigger.

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

-Name

Určuje názvy naplánovaných úloh. Add-JobTrigger přidá triggery úloh do zadaných naplánovaných úloh. Zástupné cardy jsou podporované.

Pokud chcete získat názvy naplánovaných úloh v místním nebo vzdáleném počítači, použijte rutinu Get-ScheduledJob.

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

-Trigger

Určuje aktivační události úlohy, které se mají přidat. Zadejte tabulku hash, která určuje aktivační události úlohy nebo proměnnou, která obsahuje objekty ScheduledJobTrigger , nebo zadejte příkaz nebo výraz, který získá ScheduledJobTrigger objekty, například Get-JobTrigger příkaz. Objekty ScheduledJobTrigger můžete také převést na Add-JobTrigger.

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

Vstupy

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

Triggery úloh nebo naplánované úlohy můžete předvést do add-JobTrigger.

Výstupy

None

Tato rutina nevrací žádný výstup.