Megosztás a következőn keresztül:

Resume-Job

  • Referencia
Modul:
Microsoft.PowerShell.Core

Felfüggesztett feladat újraindítása.

Syntax

Resume-Job
      [-Wait]
      [-Id] <Int32[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Resume-Job
      [-Job] <Job[]>
      [-Wait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Resume-Job
      [-Wait]
      [-Name] <String[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Resume-Job
      [-Wait]
      [-InstanceId] <Guid[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Resume-Job
      [-Wait]
      [-State] <JobState>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Resume-Job
      [-Wait]
      [-Filter] <Hashtable>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

A Resume-Job parancsmag egy felfüggesztett munkafolyamat-feladatot folytat, például a parancsmag vagy a Suspend-Job about_Suspend-Munkafolyamat tevékenység használatával. A munkafolyamat-feladatok folytatásakor a feladatmotor rekonstruálja a mentett erőforrások, például ellenőrzőpontok állapotát, metaadatait és kimenetét. A feladat állapot- vagy adatvesztés nélkül újraindul. A feladat állapota Felfüggesztettről Futtatásra módosul.

A feladatok kiválasztásához használja a paramétereket Resume-Job név, azonosító, példányazonosító vagy feladatobjektum ( például a Get-Job parancsmag Resume-Jobáltal visszaadott ) alapján. A folytatandó feladat kiválasztásához tulajdonságszűrőt is használhat.

Alapértelmezés szerint azonnal visszatér, Resume-Job annak ellenére, hogy az összes feladat még nem folytatódik. Ha el szeretné tiltani a parancssort az összes megadott feladat folytatásáig, használja a Wait paramétert.

A Resume-Job parancsmag csak egyéni feladattípusokon, például munkafolyamat-feladatokon működik. Nem működik szabványos háttérfeladatokon, például a Start-Job parancsmaggal indított feladatokon. Ha nem támogatott típusú feladatot küld el, leállítja a hibát, Resume-Job és leáll.

Munkafolyamat-feladat azonosításához keresse meg a PSWorkflowJob értékét a feladat PSJobTypeName tulajdonságában. Annak megállapításához, hogy egy adott egyéni feladattípus támogatja-e a Resume-Job parancsmagot, tekintse meg az egyéni feladattípus súgótémaköröket.

Mielőtt feladatparancsmagot használ egy egyéni feladattípushoz, importálja az egyéni feladattípust támogató modult a parancsmag használatával Import-Module , vagy a modulban lévő parancsmag beolvasásával vagy használatával.

Ezt a parancsmagot a Windows PowerShell 3.0-ban vezettük be.

Példák

1. példa: Feladat folytatása azonosító alapján

A példában szereplő parancsok ellenőrzik, hogy a feladat felfüggesztett munkafolyamat-feladat-e, majd folytatja-e a feladatot. Az első parancs a Get-Job parancsmagot használja a feladat lekéréséhez. A kimenet azt mutatja, hogy a feladat egy felfüggesztett munkafolyamat-feladat. A második parancs a parancsmag Azonosító paraméterével Resume-Job folytatja a feladatot 4 azonosító értékkel.

PS C:\> Get-Job EventJob
Id     Name            PSJobTypeName   State         HasMoreData     Location   Command
--     ----            -------------   -----         -----------     --------   -------
4      EventJob        PSWorkflowJob   Suspended     True            Server01   \\Script\Share\Event.ps1

PS C:\> Resume-Job -Id 4

2. példa: Feladat folytatása név szerint

Ez a parancs a Név paraméter használatával folytat több munkafolyamat-feladatot a helyi számítógépen.

PS C:\> Resume-Job -Name WorkflowJob, InventoryWorkflow, WFTest*

3. példa: Egyéni tulajdonságértékek használata

Ez a parancs egy egyéni tulajdonság értékét használja a munkafolyamat-feladat folytatásához. A Szűrő paraméter használatával azonosítja a munkafolyamat-feladatot a CustomID tulajdonsága alapján. Az Állapot paramétert is használja annak ellenőrzésére, hogy a munkafolyamat-feladat fel van-e függesztve, mielőtt megpróbálná folytatni.

PS C:\> Resume-Job -Filter @{CustomID="T091291"} -State Suspended

4. példa: Az összes felfüggesztett feladat folytatása távoli számítógépen

Ez a parancs folytatja az összes felfüggesztett feladatot az Srv01 távoli számítógépen.

PS C:\> Invoke-Command -ComputerName Srv01 -ScriptBlock {Get-Job -State Suspended | Resume-Job}

A parancs a Invoke-Command parancsmaggal futtat egy parancsot az Srv01 számítógépen. A távoli parancs a parancsmag Állapot paraméterét használja a Get-Job számítógépen lévő összes felfüggesztett feladat lekéréséhez. A folyamatüzemeltető (|) elküldi a felfüggesztett feladatokat a Resume-Job parancsmagnak, amely folytatja azokat.

5. példa: Várjon, amíg a feladatok folytatódnak

Ez a parancs a Wait paramétert használja a közvetlen Resume-Job visszatéréshez, csak az összes megadott feladat folytatása után. A Wait paraméter különösen olyan szkriptekben hasznos, amelyek feltételezik, hogy a feladatok a szkript folytatása előtt folytatódnak.

PS C:\> Resume-Job -Name WorkflowJob, InventoryWorkflow, WFTest* -Wait

6. példa: Saját magát felfüggesztő munkafolyamat folytatása

Ez a kódminta egy Suspend-Workflow munkafolyamat tevékenységeit mutatja be.

A Test-Suspend munkafolyamat a Server01 számítógépen. A munkafolyamat futtatásakor a munkafolyamat futtatja a Get-Date tevékenységet, és az eredményt a $a változóban tárolja. Ezután futtatja a Suspend-Workflow tevékenységet. Válaszul egy ellenőrzőpontot vesz igénybe, felfüggeszti a munkafolyamatot, és visszaad egy munkafolyamat-feladatobjektumot. Suspend-Workflow akkor is visszaad egy munkafolyamat-feladatobjektumot, ha a munkafolyamat nem kifejezetten feladatként fut.

Resume-Job folytatja a munkafolyamatot a Test-Suspend Job8-ban. A Wait paraméter használatával tartja a parancssort a feladat folytatásáig.

A Receive-Job parancsmag lekéri a Test-Suspend munkafolyamat eredményeit. A munkafolyamat utolsó parancsa egy TimeSpan objektumot ad vissza, amely az aktuális dátum és idő, valamint a változóban $a a munkafolyamat felfüggesztése előtt mentett dátum és idő közötti eltelt időt jelöli.

#SampleWorkflow
Workflow Test-Suspend
{
    $a = Get-Date
    Suspend-Workflow
    (Get-Date)- $a
}

PS C:\> Test-Suspend -PSComputerName Server01
Id     Name            PSJobTypeName   State         HasMoreData     Location             Command
--     ----            -------------   -----         -----------     --------             -------
8      Job8            PSWorkflowJob   Suspended     True            Server01             Test-Suspend

PS C:\> Resume-Job -Name "Job8" -Wait
Id     Name            PSJobTypeName   State         HasMoreData     Location             Command
--     ----            -------------   -----         -----------     --------             -------
8      Job8            PSWorkflowJob   Running       True            Server01             Test-Suspend

PS C:\> Receive-Job -Name Job8
        Days              : 0
        Hours             : 0
        Minutes           : 0
        Seconds           : 19
        Milliseconds      : 823
        Ticks             : 198230041
        TotalDays         : 0.000229432917824074
        TotalHours        : 0.00550639002777778
        TotalMinutes      : 0.330383401666667
        TotalSeconds      : 19.8230041
        TotalMilliseconds : 19823.0041
        PSComputerName    : Server01

A Resume-Job parancsmaggal folytathatja a tevékenység használatával felfüggesztett munkafolyamat-feladatokat Suspend-Workflow . Ez a tevékenység felfüggeszt egy munkafolyamatot egy munkafolyamaton belülről. Csak munkafolyamatokban érvényes.

A about_Suspend-Workflow Suspend-Workflow](.) című témakörben talál további információt. /PSWorkflow/about/about_Suspend-Workflow.md).

Paraméterek

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

Típus:SwitchParameter
Aliasok:cf
Position:Named
Alapértelmezett érték:False
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Filter

A feltételek kivonattábláját adja meg. Ez a parancsmag olyan feladatokat folytat, amelyek megfelelnek a kivonattáblában szereplő összes feltételnek. Adjon meg egy kivonattáblát, amelyben a kulcsok feladattulajdonságok, az értékek pedig a feladattulajdonságok értékei.

Típus:Hashtable
Position:0
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-Id

Megadja azoknak a feladatoknak a azonosítóit, amelyeket a parancsmag folytat.

Az azonosító egy egész szám, amely egyedileg azonosítja a feladatot az aktuális munkamenetben. Egyszerűbb megjegyezni és begépelni, mint a példányazonosítót, de csak az aktuális munkamenetben egyedi. Beírhat egy vagy több azonosítót vesszővel elválasztva. Egy feladat azonosítójának megkereséséhez futtassa a parancsot Get-Job.

Típus:Int32[]
Position:0
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-InstanceId

A parancsmag által újraindult feladatok példányazonosítóinak tömbje. Az alapértelmezett beállítás az összes feladat.

A példányazonosító egy GUID, amely egyedileg azonosítja a feladatot a számítógépen. Egy feladat példányazonosítójának megkereséséhez futtassa a következőt Get-Job: .

Típus:Guid[]
Position:0
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-Job

Megadja a folytatni kívánt feladatokat. Adjon meg egy változót, amely tartalmazza a feladatokat vagy a feladatokat lekérő parancsot. A feladatokat a Resume-Job parancsmagra is átirányíthatja.

Típus:Job[]
Position:0
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-Name

Azoknak a feladatoknak a rövid neveit adja meg, amelyeket a parancsmag folytat. Adjon meg egy vagy több feladatnevet. A helyettesítő karakterek használata engedélyezett.

Típus:String[]
Position:0
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-State

Meghatározza a folytatandó feladatok állapotát. A paraméter elfogadható értékei a következők:

  • NotStarted
  • Futó
  • Befejeződött
  • Sikertelen
  • Leállítva
  • Blokkolva
  • Felfüggesztve
  • Leválasztva
  • Felfüggesztés
  • Leállás

Ez a parancsmag csak felfüggesztett állapotú feladatokat folytat.

A feladatállapotokról további információt a JobState Enumerálás című témakörben talál.

Típus:JobState
Elfogadott értékek:NotStarted, Running, Completed, Failed, Stopped, Blocked, Suspended, Disconnected, Suspending, Stopping, AtBreakpoint
Position:0
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-Wait

Azt jelzi, hogy ez a parancsmag mindaddig letiltja a parancssort, amíg az összes feladat eredménye újra nem indul. Alapértelmezés szerint ez a parancsmag azonnal visszaadja a rendelkezésre álló eredményeket.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

Típus:SwitchParameter
Aliasok:wi
Position:Named
Alapértelmezett érték:False
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

Bevitelek

Job

Ehhez a parancsmaghoz minden típusú feladatot be lehet csövezni. Ha Resume-Job nem támogatott típusú feladatot kap, az végződési hibát ad vissza.

Kimenetek

None, System.Management.Automation.Job

Ez a parancsmag visszaadja azokat a feladatokat, amelyeket megpróbál folytatni, ha a PassThru paramétert használja. Ellenkező esetben ez a parancsmag nem hoz létre kimenetet.

Jegyzetek

A Windows PowerShell a következő aliasokat Resume-Jobtartalmazza:

  • rujb

  • Resume-Job csak felfüggesztett feladatokat folytathat. Ha egy feladatot más állapotban küld el, Resume-Job futtatja az önéletrajzi műveletet a feladaton, de figyelmeztetést küld, amely értesíti Önt arról, hogy a feladat nem folytatható. A figyelmeztetés letiltásához használja a WarningAction common paramétert a SilentlyContinue értékkel.

  • Ha egy feladat nem olyan típusú, amely támogatja az újraindulást, például egy munkafolyamat-feladatot (PSWorkflowJob), Resume-Job a függvény végződési hibát ad vissza.

  • A felfüggesztett feladatok mentésének mechanizmusa és helye a feladat típusától függően változhat. A felfüggesztett munkafolyamat-feladatok például alapértelmezés szerint egy egyszerű fájltárolóba vannak mentve, de SQL-adatbázisban is menthetők.

  • A feladat folytatásakor a feladat állapota felfüggesztve állapotúra változik. Ha meg szeretné keresni a futó feladatokat, beleértve a parancsmag által újraindított feladatokat is, a parancsmag Állapot paraméterével Get-Job lekérheti a feladatokat a Futó állapotban.

  • Egyes feladattípusok olyan beállításokkal vagy tulajdonságokkal rendelkeznek, amelyek megakadályozzák, hogy a Windows PowerShell felfüggesztse a feladatot. Ha nem sikerül felfüggeszteni a feladatot, ellenőrizze, hogy a feladat beállításai és tulajdonságai engedélyezik-e a felfüggesztést.