Udostępnij przez

Add-JobTrigger

Moduł:
PSScheduledJob Module

Dodaje wyzwalacze zadań do zaplanowanych zadań.

Składnia

JobDefinition (domyślnie) 

Add-JobTrigger
    [-Trigger] <ScheduledJobTrigger[]>
    [-InputObject] <ScheduledJobDefinition[]>
    [<CommonParameters>]

JobDefinitionName 

Add-JobTrigger
    [-Trigger] <ScheduledJobTrigger[]>
    [-Name] <String[]>
    [<CommonParameters>]

JobDefinitionId 

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 wyzwalacza Add-JobTrigger, aby zidentyfikować wyzwalacze zadania do dodania. Użyj parametrów Name, IDlub InputObject parametrów Add-JobTrigger, aby zidentyfikować zaplanowane zadanie, do którego są dodawane wyzwalacze.

Aby utworzyć wyzwalacze zadania dla wartości parametru Trigger, 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 jest dołączony do programu 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 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 codziennego zadania 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 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, aby pobrać wszystkie zaplanowane zadania 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.

Właściwości parametru

Typ:

Int32[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

JobDefinitionId
Position:0
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-InputObject

Określa zaplanowane zadania. Wprowadź zmienną zawierającą obiekty ScheduledJob lub wpisz polecenie lub wyrażenie, które pobiera scheduledJob obiektów, takich jak polecenie Get-ScheduledJob. Można również potokować obiekty ScheduledJob, aby add-JobTrigger.

Właściwości parametru

Typ:

ScheduledJobDefinition[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

JobDefinition
Position:0
Obowiązkowe:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Name

Określa nazwy zaplanowanych zadań. add-JobTrigger dodaje wyzwalacze zadania do określonych zaplanowanych zadań. Symbole wieloznaczne są obsługiwane.

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

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

JobDefinitionName
Position:0
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Trigger

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

Właściwości parametru

Typ:

ScheduledJobTrigger[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:1
Obowiązkowe:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

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

Wyzwalacze zadań lub zaplanowane zadania można potokować, aby add-JobTrigger.

Dane wyjściowe

None

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