Invoke-AsWorkflow

  • Reference
Modul:
PSWorkflowUtility

Spustí příkaz nebo výraz jako pracovní postup Windows PowerShellu.

Syntax

Invoke-AsWorkflow
      [-CommandName <String>]
      [-Parameter <Hashtable>]
      [-InputObject <Object>]
      [<CommonParameters>]
Invoke-AsWorkflow
      [-Expression <String>]
      [-InputObject <Object>]
      [<CommonParameters>]

Description

Pracovní Invoke-AsWorkflow postup spouští libovolný příkaz nebo výraz jako vložený skript v pracovním postupu. Tyto pracovní postupy používají standardní sémantiku pracovního postupu, mají všechny společné parametry pracovního postupu a mají všechny výhody pracovních postupů, včetně možnosti zastavit, obnovit a obnovit.

Pracovní postupy jsou navržené pro dlouhotrvající příkazy, které shromažďují důležitá data, ale dají se použít ke spuštění libovolného příkazu. Další informace najdete v tématu about_Workflows.

Do tohoto příkazu můžete také přidat běžné parametry pracovního postupu. Další informace o běžných parametrech pracovního postupu najdete v tématu about_WorkflowCommonParameters

Tento pracovní postup je zaveden v prostředí Windows PowerShell 3.0.

Příklady

Příklad 1: Spuštění rutiny jako pracovního postupu

Invoke-AsWorkflow -PSComputerName (Get-Content Servers.txt) -CommandName Get-ExecutionPolicy

PSComputerName                     PSSourceJobInstanceId                   Value
--------------                     ---------------------                   -----
Server01                           77b1cdf8-8226-4662-9067-cd2fa5c3b711    AllSigned
Server02                           a33542d7-3cdd-4339-ab99-0e7cd8e59462    Unrestricted
Server03                           279bac28-066a-4646-9497-8fcdcfe9757e    AllSigned
localhost                          0d858009-2cc4-47a4-a2e0-da17dc2883d0    RemoteSigned

Tento příkaz spustí rutinu Get-ExecutionPolicy jako pracovní postup na stovkách počítačů.

Příkaz používá parametr CommandName k určení rutiny, která se spouští v pracovním postupu. Používá společný parametr pracovního postupu PSComputerName k určení počítačů, na kterých se příkaz spouští. Hodnota parametru PSComputerName je Get-Content příkaz, který získá seznam názvů počítačů ze souboru Servers.txt. Hodnota parametru je uzavřena v závorkách, aby před použitím hodnoty nasměrovala prostředí Windows PowerShell ke Get-Command spuštění příkazu.

Stejně jako u všech vzdálených příkazů platí, že pokud příkaz běží na místním počítači (pokud hodnota parametru PSComputerName obsahuje místní počítač), musíte spustit Windows PowerShell s možností Spustit jako správce.

Příklad 2: Spuštění rutiny s parametry

$s = Import-Csv .\Servers.csv -Header ServerName, ServerID
Invoke-AsWorkflow -CommandName Get-ExecutionPolicy -Parameter @{Scope="Process"} -PSComputerName {$s.ServerName} -PSConnectionRetryCount 5

První příkaz pomocí rutiny Import-Csv vytvoří objekt z obsahu v souboru Servers.csv. Příkaz pomocí parametru Header vytvoří ServerName vlastnost pro sloupec, který obsahuje názvy cílových počítačů, označované také jako "vzdálené uzly". Příkaz uloží výsledek do $s proměnné.

Druhý příkaz používá Invoke-AsWorkflow pracovní postup ke spuštění Get-ExecutionPolicy příkazu na počítačích v Servers.csv souboru. Příkaz pomocí parametru Invoke-AsWorkflow CommandName určuje příkaz, který se má spustit v pracovním postupu. Pomocí parametru Invoke-AsWorkflow určuje Scope parametr Get-ExecutionPolicy rutiny s hodnotou Process.Parameter Příkaz také používá PSConnectionRetryCount společný parametr pracovního postupu k omezení příkazu na pět pokusů v každém počítači a PSComputerName společný parametr pracovního postupu k určení názvů vzdálených uzlů (cílových počítačů). Hodnota parametru PSComputerName je výraz, který získá ServerName vlastnost každého objektu $s v proměnné.

Tyto příkazy spouští Get-ExecutionPolicy příkaz jako pracovní postup ve stovkách počítačů. Příkaz používá Scope parametr Get-ExecutionPolicy rutiny s hodnotou Process k získání zásad spouštění v aktuální relaci.

Příklad 3: Spuštění výrazu jako pracovního postupu

Invoke-AsWorkflow -Expression "ipconfig /all" -PSComputerName (Get-Content DomainControllers.txt) -AsJob -JobName IPConfig

Id     Name          PSJobTypeName   State         HasMoreData   Location                Command
--     ----          -------------   -----         -----------   --------                -------
2      IpConfig      PSWorkflowJob   Completed     True          Server01, Server01...   Invoke-AsWorkflow

Tento příkaz používá Invoke-AsWorkflow pracovní postup ke spuštění příkazu Ipconfig jako úlohy pracovního postupu na počítačích uvedených v souboru DomainControllers.txt.

Příkaz použije Expression parametr k určení výrazu, který se má spustit. Používá PSComputerName společný parametr pracovního postupu k určení názvů vzdálených uzlů (cílových počítačů).

Příkaz také používá AsJob společné parametry a JobName parametry pracovního postupu ke spuštění pracovního postupu jako úlohy na pozadí na každém počítači s názvem úlohy Ipconfig.

Příkaz vrátí ContainerParentJob objekt (System.Management.Automation.ContainerParentJob), který obsahuje úlohy pracovního postupu v každém počítači.

Parametry

-CommandName

Spustí zadanou rutinu nebo pokročilou funkci jako pracovní postup. Zadejte název rutiny nebo funkce, například Update-Help, Set-ExecutionPolicynebo Set-NetFirewallRule.

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

-Expression

Určuje výraz, který tato rutina spouští jako pracovní postup. Zadejte výraz jako řetězec, například "ipconfig /all". Pokud výraz obsahuje mezery nebo speciální znaky, uzavřete výraz do uvozovek.

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

-InputObject

Slouží k povolení vstupu kanálu.

Type:Object
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Parameter

Určuje parametry a hodnoty parametrů příkazu zadaného v parametru CommandName . Zadejte tabulku hash, ve které je každý klíč název parametru a jeho hodnota je hodnota parametru, například @{ExecutionPolicy="AllSigned"}.

Informace o tabulkách hash najdete v tématu about_Hash_Tables.

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Vstupy

Object

Do této rutiny můžete převést libovolný objekt.

Výstupy

None

Tento příkaz nevrátí žádný vlastní výstup, ale pracovní postup, který spustí, může vrátit výstup.