Udostępnij za pośrednictwem

Add-JobTrigger

  • Odwołanie
Moduł:
PSScheduledJob

Dodaje wyzwalacze zadań do zaplanowanych zadań.

Składnia

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

Opis

Polecenie cmdlet Add-JobTrigger dodaje wyzwalacze zadań do zaplanowanych zadań. Służy do dodawania wielu wyzwalaczy do wielu zaplanowanych zadań.

Wyzwalacz zadania uruchamia zaplanowane zadanie w jednorazowym lub cyklicznym harmonogramie lub w przypadku wystąpienia zdarzenia.

Użyj parametru Trigger polecenia Add-JobTrigger , aby zidentyfikować wyzwalacze zadania do dodania. Użyj parametrów Name, ID lub InputObject funkcji Add-JobTrigger , aby zidentyfikować zaplanowane zadanie, do którego są dodawane wyzwalacze.

Aby utworzyć wyzwalacze zadania dla wartości parametru Wyzwalacz , użyj polecenia cmdlet New-JobTrigger lub użyj tabeli skrótów, aby określić wyzwalacz zadania.

Add-JobTrigger jest jedną z kolekcji poleceń cmdlet planowania zadań w module PSScheduledJob, który znajduje się w Windows PowerShell.

Aby uzyskać więcej informacji na temat zaplanowanych zadań, zobacz Tematy o tematach w module PSScheduledJob. Zaimportuj moduł PSScheduledJob, a następnie wpisz: Get-Help about_Scheduled* lub zobacz about_Scheduled_Jobs.

To polecenie cmdlet zostało wprowadzone w Windows PowerShell 3.0.

Przykłady

Przykład 1. Dodawanie wyzwalacza zadania do zaplanowanego zadania

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

Te polecenia dodają wyzwalacz Codzienne zadanie do zaplanowanego zadania TestJob.

Pierwsze polecenie używa polecenia cmdlet New-JobTrigger do utworzenia wyzwalacza zadania uruchamiającego zaplanowane zadanie codziennie o godzinie 3:00. Polecenie zapisuje wyzwalacz zadania w zmiennej $Daily.

Drugie polecenie używa polecenia cmdlet Add-JobTrigger , aby dodać wyzwalacz zadania w zmiennej $Startup do zaplanowanego zadania TestJob.

Przykład 2. Dodawanie wyzwalacza zadania do kilku zaplanowanych zadań

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

To polecenie dodaje wyzwalacz zadania AtStartup do wszystkich zaplanowanych zadań na komputerze lokalnym. Używa Get-ScheduledJob do pobierania wszystkich zaplanowanych zadań na komputerze. Używa operatora potoku (|) do wysyłania zadań do polecenia cmdlet Add-JobTrigger , które dodaje wyzwalacz zadania do każdego z zaplanowanych zadań. Wartość parametru Trigger to polecenie New-JobTrigger, które tworzy wyzwalacz zadania AtStartup.

Przykład 3. Kopiowanie wyzwalacza zadania

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

Te polecenia kopiują wyzwalacz zadania z zaplanowanego zadania BackupArchives i dodają je do zaplanowanych zadań TestBackup i BackupLogs.

Pierwsze polecenie używa polecenia cmdlet Get-JobTrigger w celu pobrania wyzwalacza zadania zaplanowanego zadania BackupArchives. Polecenie zapisuje wyzwalacz w zmiennej $t.

Drugie polecenie używa polecenia cmdlet Add-JobTrigger , aby dodać wyzwalacz zadania w $t do zaplanowanych zadań TestBackup i BackupLogs.

Parametry

-Id

Określa numery identyfikacyjne zaplanowanych zadań. Add-JobTrigger dodaje wyzwalacz zadania do określonych zaplanowanych zadań.

Aby uzyskać numer identyfikacyjny zaplanowanych zadań na komputerze lokalnym lub komputerze zdalnym, użyj polecenia cmdlet Get-ScheduledJob.

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

-InputObject

Określa zaplanowane zadania. Wprowadź zmienną zawierającą obiekty ScheduledJob lub wpisz polecenie lub wyrażenie, które pobiera obiekty ScheduledJob , takie jak polecenie Get-ScheduledJob. Można również potokować obiekty ScheduledJob do polecenia Add-JobTrigger.

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

-Name

Określa nazwy zaplanowanych zadań. Dodatek JobTrigger dodaje wyzwalacze zadania do określonych zaplanowanych zadań. Obsługiwane są symbole wieloznaczne.

Aby uzyskać nazwy zaplanowanych zadań na komputerze lokalnym lub komputerze zdalnym, użyj polecenia cmdlet Get-ScheduledJob.

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

-Trigger

Określa wyzwalacze zadania do dodania. Wprowadź tabelę skrótów, która określa wyzwalacze zadań lub zmienną zawierającą obiekty ScheduledJobTrigger , lub wpisz polecenie lub wyrażenie, które pobiera obiekty ScheduledJobTrigger , takie jak polecenie Get-JobTrigger. Można również potokować obiekty ScheduledJobTrigger do polecenia Add-JobTrigger.

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

Dane wejściowe

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

Wyzwalacze zadań lub zaplanowane zadania można potokować do polecenia Add-JobTrigger.

Dane wyjściowe

None

To polecenie cmdlet nie zwraca żadnych danych wyjściowych.