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 .

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 Get-ScheduledJob polecenie. Można również potokować obiekty ScheduledJob do Add-JobTrigger.

Type:Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 .

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, 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 .

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

Dane wejściowe

Microsoft.PowerShell.ScheduledJob.ScheduledJobTrigger

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

Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

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

Dane wyjściowe

None

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