Dela via

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[]>]
   [-Name] <String>
   [<CommonParameters>]
Get-JobTrigger
   [[-TriggerId] <Int32[]>]
   [-Id] <Int32>
   [<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 parametrarna för cmdleten Get-JobTrigger för att identifiera schemalagda jobb. Du kan identifiera de schemalagda jobben med deras namn eller ID-nummer, eller genom att ange eller skicka ScheduledJob- objekt, till exempel de som returneras av Get-ScheduledJob cmdlet, för att 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

PS C:\> Get-JobTrigger -Name "BackupJob"

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

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

The first command uses the Get-ScheduledJob cmdlet to display the scheduled jobs on the local computer. The display includes the IDs of the scheduled jobs.
PS C:\> 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

The second command uses the **Get-JobTrigger** cmdlet to get the job trigger for the Test-HelpFiles job (ID = 3)
PS C:\> Get-JobTrigger -ID 3

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

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

PS C:\> Get-ScheduledJob -Name *Backup*, *Archive* | Get-JobTrigger

Det här kommandot hämtar jobbutlösare för alla jobb som har säkerhetskopiering eller arkiv i sina namn.

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

PS C:\> Invoke-Command -ComputerName Server01 { Get-ScheduledJob Backup | Get-JobTrigger -TriggerID 2 }

Det här kommandot hämtar en av de två jobbutlösarna för ett schemalagt jobb på en fjärrdator.

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 schemalagda säkerhetskopieringsjobbet, 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

PS C:\> 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

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

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 funktionen för beräknad egenskap i cmdleten Format-Table. 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

The command uses the Get-ScheduledJob cmdlet to get the Test-HelpFiles scheduled job. Then it uses the dot method (.) to get the JobTriggers property of the Test-HelpFiles scheduled job.
PS C:\> (Get-ScheduledJob Test-HelpFiles).JobTriggers

The second command uses the Get-ScheduledJob cmdlet to get all scheduled jobs on the local computer. It uses the ForEach-Object cmdlet to get the value of the JobTrigger property of each scheduled job.
PS C:\> Get-ScheduledJob | foreach {$_.JobTriggers}

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. Resultatet är identiskt med cmdleten Get-JobTrigger och teknikerna kan användas omväxlande.

Exempel 7: Jämför jobbutlösare

The first command gets the job trigger of the ArchiveProjects scheduled job. The command pipes the job trigger to the Tee-Object cmdlet, which saves the job trigger in the $T1 variable and displays it at the command line.
PS C:\> 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

The second command gets the job trigger of the Test-HelpFiles scheduled job. The command pipes the job trigger to the Tee-Object cmdlet, which saves the job trigger in the $T2 variable and displays it at the command line.
PS C:\> 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

The third command compares the job triggers in the $t1 and $t2 variables. It uses the Get-Member cmdlet to get the properties of the job trigger in the $t1 variable. It pipes the properties to the ForEach-Object cmdlet, which compares each property to the properties of the job trigger in the $t2 variable by name. The command then pipes the differing properties to the Format-List cmdlet, which displays them in a list.The output indicates that, although the job triggers appear to be the same, the HelpFiles job trigger includes a random delay of three (3) minutes.
PS C:\> $T1 | Get-Member -Type Property | ForEach-Object { Compare-Object $T1 $T2 -Property $_.Name}
RandomDelay                                                 SideIndicator
-----------                                                 -------------
00:00:00                                                    =>
00:03:00                                                    <=

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.

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

Typ:Int32
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:ScheduledJobDefinition
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken: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.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken: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 Name, IDeller InputObject har flera jobbutlösare.

Typ:Int32[]
Position:1
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

ScheduledJobDefinition

Du kan skicka ett schemalagt jobb från Get-ScheduledJob till Get-JobTrigger.

Utdata

ScheduledJobTrigger