Sdílet prostřednictvím

Add-JobTrigger

  • Reference
Modul:
PSScheduledJob

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

Syntaxe

Add-JobTrigger
   [-Trigger] <ScheduledJobTrigger[]>
   [-InputObject] <ScheduledJobDefinition[]>
   [<CommonParameters>]
Add-JobTrigger
   [-Trigger] <ScheduledJobTrigger[]>
   [-Id] <Int32[]>
   [<CommonParameters>]
Add-JobTrigger
   [-Trigger] <ScheduledJobTrigger[]>
   [-Name] <String[]>
   [<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 několika naplánovaných úloh.

Trigger úlohy spustí naplánovanou úlohu na jednorázovém nebo opakovaném plánu nebo v případě, že dojde k události.

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

Pokud chcete vytvořit aktivační události úlohy 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 PowerShellu.

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

Tato rutina byla zavedena ve Windows PowerShellu 3.0.

Příklady

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

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

Tyto příkazy přidávají aktivační událost každodenní úlohy do naplánované úlohy TestJob.

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

Druhý příkaz pomocí rutiny Add-JobTrigger přidá trigger úlohy do proměnné $Startup do naplánované úlohy TestJob.

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

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 Add-JobTrigger rutiny, která do každé naplánované úlohy přidá trigger úlohy. Hodnota parametru Trigger je New-JobTrigger příkaz, který vytvoří trigger úlohy AtStartup.

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

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

Tyto příkazy zkopírují trigger úlohy z naplánované úlohy BackupArchives a přidají ho do plá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 pomocí rutiny Add-JobTrigger přidá trigger úlohy v $t do plá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.

K získání identifikačního počtu naplánovaných úloh na místním počítači nebo vzdáleném počítači použijte rutinu Get-ScheduledJob .

Typ:Int32[]
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-InputObject

Určuje naplánované úlohy. Zadejte proměnnou obsahující 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řevést na Add-JobTrigger.

Typ:ScheduledJobDefinition[]
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Name

Určuje názvy naplánovaných úloh. Add-JobTrigger přidá triggery úlohy do zadaných naplánovaných úloh. Podporují se zástupné kóty.

Názvy naplánovaných úloh získáte na místním počítači nebo ve vzdáleném počítači pomocí rutiny Get-ScheduledJob .

Typ:String[]
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Trigger

Určuje triggery úlohy, které se mají přidat. Zadejte tabulku hash, která určuje aktivační události úlohy nebo proměnnou obsahující objekty ScheduledJobTrigger , nebo zadejte příkaz nebo výraz, který získá objekty ScheduledJobTrigger , například Get-JobTrigger příkaz. Objekty ScheduledJobTrigger lze také ručně ručně nasoupat do Add-JobTriggerobjektu .

Typ:ScheduledJobTrigger[]
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Vstupy

ScheduledJobTrigger

Do této rutiny můžete spustit trigger úlohy.

ScheduledJobDefinition

Do této rutiny můžete převést naplánovanou úlohu.

Výstupy

None

Tato rutina nevrátí žádný výstup.