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

Opis

Polecenie Add-JobTrigger cmdlet 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 elementu Add-JobTrigger , aby zidentyfikować zaplanowane zadanie, do którego są dodawane wyzwalacze.

Aby utworzyć wyzwalacze zadania dla wartości parametru Wyzwalacz , użyj New-JobTrigger polecenia cmdlet 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 programie Windows PowerShell.

Aby uzyskać więcej informacji na temat zaplanowanych zadań, zobacz temat Informacje 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 programie Windows PowerShell 3.0.

Przykłady

Przykład 1. Dodawanie wyzwalacza zadania do zaplanowanego zadania

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

Te polecenia dodają wyzwalacz codziennego zadania do zaplanowanego zadania TestJob.

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

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

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

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 elementu , aby pobrać wszystkie zaplanowane zadania na komputerze. Używa operatora potoku (|) do wysyłania zadań do Add-JobTrigger polecenia cmdlet, które dodaje wyzwalacz zadania do każdego z zaplanowanych zadań. Wartość parametru Trigger to New-JobTrigger polecenie, które tworzy wyzwalacz zadania AtStartup.

Przykład 3. Kopiowanie wyzwalacza zadania

$T = Get-JobTrigger -Name "BackupArchives"
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 Get-JobTrigger polecenia cmdlet do pobrania wyzwalacza zadania backupArchives zaplanowanego zadania. Polecenie zapisuje wyzwalacz w zmiennej $t.

Drugie polecenie używa Add-JobTrigger polecenia cmdlet , 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 Get-ScheduledJob polecenia cmdlet .

Typ:Int32[]
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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 Get-ScheduledJob polecenie. Można również potokować obiekty ScheduledJob do Add-JobTrigger.

Typ:ScheduledJobDefinition[]
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Name

Określa nazwy zaplanowanych zadań. Add-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 Get-ScheduledJob polecenia cmdlet .

Typ:String[]
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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, albo wpisz polecenie lub wyrażenie, które pobiera obiekty ScheduledJobTrigger, takie jak Get-JobTrigger polecenie. Można również potokować obiekty ScheduledJobTrigger do Add-JobTriggerobiektu .

Typ:ScheduledJobTrigger[]
Position:1
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

ScheduledJobTrigger

Możesz przekazać wyzwalacz zadania do tego polecenia cmdlet.

ScheduledJobDefinition

Możesz przekazać zaplanowane zadanie do tego polecenia cmdlet.

Dane wyjściowe

None

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