Invoke-AsWorkflow
Kör ett kommando eller uttryck som ett Windows PowerShell arbetsflöde.
Syntax
Invoke-AsWorkflow
[-CommandName <String>]
[-Parameter <Hashtable>]
[-InputObject <Object>]
[<CommonParameters>] Invoke-AsWorkflow
[-Expression <String>]
[-InputObject <Object>]
[<CommonParameters>] Description
Arbetsflödet Invoke-AsWorkflow kör alla kommandon eller uttryck som ett infogat skript i ett arbetsflöde.
Dessa arbetsflöden använder standardarbetsflödessemantik, har alla vanliga parametrar för arbetsflöden och har alla fördelar med arbetsflöden, inklusive möjligheten att stoppa, återuppta och återställa.
Arbetsflöden är utformade för långvariga kommandon som samlar in viktiga data, men kan användas för att köra alla kommandon. Mer information finns i about_Workflows.
Du kan också lägga till vanliga parametrar för arbetsflödet i det här kommandot. Mer information om vanliga parametrar för arbetsflöden finns i about_WorkflowCommonParameters
Det här arbetsflödet introduceras i Windows PowerShell 3.0.
Exempel
Exempel 1: Kör en cmdlet som ett arbetsflöde
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 RemoteSignedDet här kommandot kör cmdleten Get-ExecutionPolicy som ett arbetsflöde på hundratals datorer.
Kommandot använder parametern CommandName för att ange cmdleten som körs i arbetsflödet.
Den använder den vanliga parametern PSComputerName-arbetsflöde för att ange de datorer som kommandot körs på.
Värdet för parametern PSComputerName är ett Get-Content kommando som hämtar en lista över datornamn från Servers.txt-filen.
Parametervärdet omges av parenteser för att dirigera Windows PowerShell att köra Get-Command kommandot innan värdet används.
Som med alla fjärrkommandon måste du börja Windows PowerShell med alternativet Kör som administratör om kommandot körs på den lokala datorn (om värdet för parametern PSComputerName innehåller den lokala datorn).
Exempel 2: Kör en cmdlet med parametrar
$s = Import-Csv .\Servers.csv -Header ServerName, ServerID
Invoke-AsWorkflow -CommandName Get-ExecutionPolicy -Parameter @{Scope="Process"} -PSComputerName {$s.ServerName} -PSConnectionRetryCount 5Det första kommandot använder cmdleten Import-Csv för att skapa ett objekt från innehållet i Servers.csv-filen. Kommandot använder parametern Header för att skapa en ServerName egenskap för kolumnen som innehåller namnen på måldatorerna, även kallade "fjärrnoder". Kommandot sparar resultatet i variabeln $s .
Det andra kommandot använder Invoke-AsWorkflow arbetsflödet för att köra ett Get-ExecutionPolicy kommando på datorerna i Servers.csv-filen. Kommandot använder parametern Invoke-AsWorkflowCommandName för för att ange kommandot som ska köras i arbetsflödet. Den använder parametern ParameterInvoke-AsWorkflow för för att ange parametern Scope för cmdleten Get-ExecutionPolicy med värdet Process. Kommandot använder också arbetsflödets PSConnectionRetryCount gemensamma parameter för att begränsa kommandot till fem försök på varje dator och arbetsflödets PSComputerName gemensamma parameter för att ange namnen på fjärrnoderna (måldatorer). Värdet för parametern PSComputerName är ett uttryck som hämtar egenskapen för ServerName varje objekt i variabeln $s .
Dessa kommandon kör ett Get-ExecutionPolicy kommando som ett arbetsflöde på hundratals datorer.
Kommandot använder parametern Scope för cmdleten Get-ExecutionPolicy med värdet Process för att hämta körningsprincipen i den aktuella sessionen.
Exempel 3: Kör ett uttryck som ett arbetsflöde
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-AsWorkflowDet här kommandot använder Invoke-AsWorkflow arbetsflödet för att köra ett Ipconfig-kommando som ett arbetsflödesjobb på datorerna som anges i DomainControllers.txt-filen.
Kommandot använder parametern Expression för att ange vilket uttryck som ska köras.
Den använder den PSComputerName vanliga arbetsflödesparametern för att ange namnen på fjärrnoderna (måldatorer).
Kommandot använder också vanliga parametrar och AsJobJobName arbetsflöden för att köra arbetsflödet som ett bakgrundsjobb på varje dator med jobbnamnet "Ipconfig".
Kommandot returnerar ett ContainerParentJob objekt (System.Management.Automation.ContainerParentJob) som innehåller arbetsflödesjobben på varje dator.
Parametrar
-CommandName
Kör den angivna cmdleten eller den avancerade funktionen som ett arbetsflöde.
Ange cmdleten eller funktionsnamnet, till exempel Update-Help, Set-ExecutionPolicyeller Set-NetFirewallRule.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Expression
Anger det uttryck som den här cmdleten körs som ett arbetsflöde.
Ange uttrycket som en sträng, till exempel "ipconfig /all".
Om uttrycket innehåller blanksteg eller specialtecken omger du uttrycket inom citattecken.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
Används för att tillåta pipelineindata.
| Type: | Object |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Parameter
Anger parametrarna och parametervärdena för kommandot som anges i parametern CommandName .
Ange en hash-tabell där varje nyckel är ett parameternamn och dess värde är parametervärdet, till exempel @{ExecutionPolicy="AllSigned"}.
Information om hash-tabeller finns i about_Hash_Tables.
| Type: | Hashtable |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Indata
Du kan skicka valfritt objekt till parametern InputObject .
Utdata
None
Det här kommandot genererar inga utdata. Den kör dock arbetsflödet, vilket kan generera utdata.