Get-JobTrigger

  • Referens
Modul:
PSScheduledJob

Hämtar jobbutlösare för schemalagda jobb.

Syntax

Get-JobTrigger
   [[-TriggerId] <Int32[]>]
   [-InputObject] <ScheduledJobDefinition>
   [<CommonParameters>]
Get-JobTrigger
   [[-TriggerId] <Int32[]>]
   [-Id] <Int32>
   [<CommonParameters>]
Get-JobTrigger
   [[-TriggerId] <Int32[]>]
   [-Name] <String>
   [<CommonParameters>]

Description

Cmdleten Get-JobTrigger hämtar jobbutlösare för schemalagda jobb. Du kan använda det här kommandot för att undersöka jobbutlösarna eller skicka jobbutlösarna till andra cmdletar.

En jobbutlösare definierar ett återkommande schema eller villkor för att starta ett schemalagt jobb. Jobbutlösare sparas inte till disken oberoende av varandra. de ingår i ett schemalagt jobb. Om du vill hämta en jobbutlösare anger du det schemalagda jobb som utlösaren startar.

Använd cmdletens Get-JobTrigger parametrar för att identifiera de schemalagda jobben. Du kan identifiera de schemalagda jobben med deras namn eller ID-nummer, eller genom att ange eller skicka schemalagda jobbobjekt , till exempel de som returneras av cmdleten Get-ScheduledJob , till Get-JobTrigger.

Get-JobTrigger är en av en samling cmdletar för jobbschemaläggning i modulen PSScheduledJob som ingår i Windows PowerShell.

Mer information om schemalagda jobb finns i Avsnittet om i modulen PSScheduledJob. Importera modulen PSScheduledJob och skriv sedan: Get-Help about_Scheduled* eller se about_Scheduled_Jobs.

Den här cmdleten introducerades i Windows PowerShell 3.0.

Exempel

Exempel 1: Hämta en jobbutlösare efter schemalagt jobbnamn

Get-JobTrigger -Name "BackupJob"

Kommandot använder parametern Get-JobTrigger Namn för för att hämta jobbutlösare för det BackupJob schemalagda jobbet.

Exempel 2: Hämta en jobbutlösare efter ID

I exemplet används ID-parametern Get-JobTrigger för för att hämta jobbutlösare för ett schemalagt jobb.

Get-ScheduledJob

Id         Name            Triggers        Command                                  Enabled
--         ----            --------        -------                                  -------
1          ArchiveProjects {1}             \\Server\Share\Archive-Projects.ps1      True
2          Backup          {1,2}           \\Server\Share\Run-Backup.ps1            True
3          Test-HelpFiles  {1}             \\Server\Share\Test-HelpFiles.ps1        True
4          TestJob         {}              \\Server\Share\Run-AllTests.ps1          True

Get-JobTrigger -ID 3

Det första kommandot använder cmdleten Get-ScheduledJob för att visa schemalagda jobb på den lokala datorn. Visningen innehåller ID:t för de schemalagda jobben.

Det andra kommandot använder cmdleten Get-JobTrigger för att hämta jobbutlösaren för Test-HelpFiles jobbet (vars ID är 3).

Exempel 3: Hämta jobbutlösare genom att skicka ett jobb

Det här exemplet hämtar jobbutlösare av jobb som har matchande namn.

Get-ScheduledJob -Name *Backup*, *Archive* | Get-JobTrigger

Det här kommandot hämtar jobbutlösare för alla jobb som har Backup eller Archive i deras namn.

Exempel 4: Hämta jobbutlösaren för ett jobb på en fjärrdator

Det här exemplet hämtar utlösarna för ett schemalagt jobb på en fjärrdator.

Invoke-Command -ComputerName Server01 { Get-ScheduledJob Backup | Get-JobTrigger -TriggerID 2 }

Kommandot använder cmdleten Invoke-Command för att köra ett kommando på Server01-datorn. Den använder cmdleten Get-ScheduledJob för att hämta det Backup schemalagda jobbet, som det skickar till cmdleten Get-JobTrigger . Den använder parametern TriggerID för att bara hämta den andra utlösaren.

Exempel 5: Hämta alla jobbutlösare

Det här exemplet hämtar alla jobbutlösare för alla schemalagda jobb på den lokala datorn.

Get-ScheduledJob | Get-JobTrigger |
    Format-Table -Property ID, Frequency, At, DaysOfWeek, Enabled, @{Label="ScheduledJob";Expression={$_.JobDefinition.Name}} -AutoSize

Id Frequency At                    DaysOfWeek Enabled ScheduledJob
-- --------- --                    ---------- ------- ------------
1    Weekly  9/28/2011 3:00:00 AM  {Monday}   True    Backup
1    Daily   9/27/2011 11:00:00 PM            True    Test-HelpFiles

Kommandot använder Get-ScheduledJob för att hämta schemalagda jobb på den lokala datorn och skickar dem till Get-JobTrigger, som hämtar jobbutlösaren för varje schemalagt jobb (om det finns några).

Om du vill lägga till namnet på det schemalagda jobbet i jobbutlösaren använder kommandot cmdletens Format-Table beräknade egenskapsfunktion. Förutom de egenskaper för jobbutlösare som visas som standard skapar kommandot en ny scheduledjob-egenskap som visar namnet på det schemalagda jobbet.

Exempel 6: Hämta jobbutlösaregenskapen för ett schemalagt jobb

Det här exemplet visar olika metoder för att visa egenskapen JobTrigger för ett schemalagt jobb.

(Get-ScheduledJob Test-HelpFiles).JobTriggers
Get-ScheduledJob | foreach {$_.JobTriggers}

Det första kommandot använder cmdleten Get-ScheduledJob för att hämta det Test-HelpFiles schemalagda jobbet. Sedan använder den dot-metoden (.) för att hämta egenskapen JobTriggers för det Test-HelpFiles schemalagda jobbet.

Det andra kommandot använder cmdleten Get-ScheduledJob för att hämta alla schemalagda jobb på den lokala datorn. Den använder cmdleten ForEach-Object för att hämta värdet för egenskapen JobTriggers för varje schemalagt jobb.

Jobbutlösarna för ett schemalagt jobb lagras i jobtriggers-egenskapen för jobbet. Det här exemplet visar alternativ till att använda cmdleten Get-JobTrigger för att hämta jobbutlösare. Resultaten är identiska med cmdleten Get-JobTrigger och teknikerna kan användas omväxlande.

Exempel 7: Jämför jobbutlösare

Get-ScheduledJob -Name ArchiveProjects | Get-JobTrigger | Tee-Object -Variable t1

Id         Frequency       Time                   DaysOfWeek              Enabled
--         ---------       ----                   ----------              -------
0          Daily           9/26/2011 3:00:00 AM                           True

Get-ScheduledJob -Name "Test-HelpFiles" | Get-JobTrigger | Tee-Object -Variable t2

Id         Frequency       Time                   DaysOfWeek              Enabled
--         ---------       ----                   ----------              -------
0          Daily           9/26/2011 3:00:00 AM                           True

$t1| Get-Member -Type Property | ForEach-Object { Compare-Object $t1 $t2 -Property $_.Name}

RandomDelay                                                 SideIndicator
-----------                                                 -------------
00:00:00                                                    =>
00:03:00                                                    <=

Det första kommandot hämtar jobbutlösaren för det ArchiveProjects schemalagda jobbet. Kommandot dirigerar jobbutlösaren till cmdleten Tee-Object , vilket sparar jobbutlösaren i variabeln $t1 och visar den på kommandoraden.

Det andra kommandot hämtar jobbutlösaren för det Test-HelpFiles schemalagda jobbet. Kommandot dirigerar jobbutlösaren till cmdleten Tee-Object , vilket sparar jobbutlösaren i variabeln $t2 och visar den på kommandoraden.

Det tredje kommandot jämför jobbutlösarna i variablerna $t1 och $t 2. Den använder cmdleten Get-Member för att hämta egenskaperna för jobbutlösaren i variabeln $t 1. Den dirigerar egenskaperna till cmdleten ForEach-Object , som jämför varje egenskap med egenskaperna för jobbutlösaren i variabeln efter $t2 namn. Kommandot dirigerar sedan de olika egenskaperna till cmdleten Format-List , som visar dem i en lista. Utdata anger att även om jobbutlösarna verkar vara desamma, HelpFiles innehåller jobbutlösaren en slumpmässig fördröjning på tre (3) minuter.

Det här exemplet visar hur du jämför jobbutlösare för två schemalagda jobb.

Parametrar

-Id

Anger identifieringsnumret för ett schemalagt jobb. Get-JobTrigger hämtar jobbutlösaren för det angivna schemalagda jobbet.

Använd cmdleten Get-ScheduledJob för att hämta identifieringsnumret för schemalagda jobb på den lokala datorn eller en fjärrdator.

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

-InputObject

Anger ett schemalagt jobb. Ange en variabel som innehåller ScheduledJob-objekt eller skriv ett kommando eller uttryck som hämtar ScheduledJob-objekt , till exempel ett Get-ScheduledJob kommando. Du kan också skicka ScheduledJob-objekt till Get-JobTrigger.

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

-Name

Anger namnet på ett schemalagt jobb. Get-JobTrigger hämtar jobbutlösaren för det angivna schemalagda jobbet. Jokertecken stöds.

Om du vill hämta namnen på schemalagda jobb på den lokala datorn eller en fjärrdator använder du cmdleten Get-ScheduledJob .

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

-TriggerId

Hämtar de angivna jobbutlösarna. Ange utlösar-ID:t för en eller flera jobbutlösare för ett schemalagt jobb. Använd den här parametern när det schemalagda jobbet som anges av parametrarna Namn, ID eller InputObject har flera jobbutlösare.

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

Indata

ScheduledJobDefinition

Du kan skicka ett schemalagt jobb till den här cmdleten.

Utdata

ScheduledJobTrigger

Den här cmdleten returnerar det schemalagda jobbets utlösare.