Informace o activityCommonParameters
KRÁTKÝ POPIS
Popisuje parametry, které Windows PowerShell pracovní postup přidává do aktivit.
DLOUHÝ POPIS
Windows PowerShell Workflow přidá společné parametry aktivity k aktivitám, které jsou odvozeny ze základní třídy PSActivity. Tato kategorie zahrnuje aktivitu InlineScript a rutiny Windows PowerShell, které jsou implementovány jako aktivity, jako jsou Get-Process a Get-WinEvent.
Společné parametry aktivity nejsou platné pro aktivity Suspend-Workflow a Checkpoint-Workflow a nepřidávají se do rutin nebo výrazů, které Windows PowerShell pracovní postup automaticky spustí v bloku skriptu InlineScript nebo podobné aktivitě. Společné parametry aktivity jsou k dispozici pro aktivitu InlineScript, ale ne pro příkazy v bloku skriptu InlineScript.
Některé společné parametry aktivity jsou také společné parametry pracovního postupu nebo Windows PowerShell společných parametrů. Další společné parametry aktivit jsou jedinečné pro aktivity.
Informace o běžných parametrech pracovního postupu najdete v tématu about_WorkflowCommonParameters. Informace o Windows PowerShell běžných parametrech najdete v tématu about_CommonParameters.
SEZNAM SPOLEČNÝCH PARAMETRŮ AKTIVITY
AppendOutput PSDebug
Debug PSDisableSerialization
DisplayName PSDisableSerializationPreference
ErrorAction PSError
Input PSPersist
MergeErrorToOutput PSPort
PSActionRetryCount PSProgress
PSActionRetryIntervalSec PSProgressMessage
PSActionRunningTimeoutSec PSRemotingBehavior
PSApplicationName PSRequiredModules
PSAuthentication PSSessionOption
PSCertificateThumbprint PSUseSSL
PSComputerName PSVerbose
PSConfigurationName PSWarning
PSConnectionRetryCount Result
PSConnectionRetryIntervalSec UseDefaultInput
PSConnectionURI Verbose
PSCredential WarningAction
POPISY PARAMETRŮ
Tato část popisuje společné parametry aktivity.
Logická hodnota AppendOutput <>
Hodnota $True
přidá výstup aktivity k hodnotě proměnné.
Hodnota nemá $False
žádný vliv. Přiřazení hodnoty proměnné ve výchozím nastavení nahradí hodnotu proměnné.
Například následující příkazy přidají objekt procesu do objektu služby v $x
proměnné.
Workflow Test-Workflow
{
$x = Get-Service
$x = Get-Process -AppendOutput $true
}
Tento parametr je určený pro pracovní postupy založené na XAML. V pracovních postupech skriptů můžete také pomocí operátoru přiřazení += přidat výstup k hodnotě proměnné, jak je znázorněno v následujícím příkladu.
Workflow Test-Workflow
{
$x = Get-Service
$x += Get-Process
}
Přepínač ladění <>
Zobrazí podrobnosti o operaci prováděné příkazem na úrovni programátora. Parametr Debug přepíše hodnotu proměnné $DebugPreference aktuálního příkazu. Tento parametr funguje pouze v případě, že příkaz vygeneruje ladicí zprávy. Tento parametr je také Windows PowerShell společný parametr.
DisplayName <String>
Určuje popisný název aktivity. Hodnota DisplayName se zobrazí na indikátoru průběhu při spuštění pracovního postupu a v hodnotě vlastnosti Progress úlohy pracovního postupu. Pokud je parametr PSProgressMessage také součástí příkazu, zobrazí se obsah indikátoru průběhu ve <formátu DisplayName>:<PSProgressMessage> .
ErrorAction <ActionPreference>
Určuje, jak aktivita reaguje na neukončující chybu z příkazu. Nemá žádný vliv na chyby ukončení. Tento parametr funguje pouze v případě, že příkaz vygeneruje neukončující chybu, například z rutiny Write-Error. Parametr ErrorAction přepíše hodnotu proměnné $ErrorActionPreference aktuálního příkazu. Tento parametr je také Windows PowerShell společný parametr.
Platné hodnoty:
Pokračovat. Zobrazí chybovou zprávu a pokračuje v provádění příkazu. "Pokračovat" je výchozí hodnota.
Ignorujte to. Potlačí chybovou zprávu a pokračuje v provádění příkazu. Na rozdíl od SilentlyContinue, Ignore nepřidá chybovou zprávu do $Error automatické proměnné. Hodnota Ignorovat je zavedena v Windows PowerShell 3.0.
Dotazem. Zobrazí chybovou zprávu a před pokračováním v provádění vás vyzve k potvrzení. Tato hodnota se používá zřídka.
Pozastavit. Automaticky pozastaví úlohu pracovního postupu, aby bylo možné provést další šetření. Po prošetření je možné pracovní postup pokračovat.
TišePokračovat. Potlačí chybovou zprávu a pokračuje v provádění příkazu.
Stop. Zobrazí chybovou zprávu a zastaví provádění příkazu.
Vstupní <objekt[]>
Odešle kolekci objektů do aktivity. Jedná se o alternativu k propojení objektů k aktivitě po jednom.
MergeErrorToOutput <Logická hodnota>
Hodnota přidá $True
chyby do výstupního datového proudu. Hodnota $False
nemá vliv. Tento parametr použijte spolu s klíčovými slovy Parallel a ForEach -Parallel
ke shromažďování chyb a výstupů z více paralelních příkazů v jedné kolekci.
PSActionRetryCount <Int32>
Pokud se první pokus nezdaří, pokusí se aktivitu spustit opakovaně. Výchozí hodnota 0 se nezopakuje.
PSActionRetryIntervalSec <Int32>
Určuje interval mezi opakovanými pokusy o akci v sekundách. Výchozí hodnota 0 akci okamžitě opakuje. Tento parametr je platný pouze v případě, že parametr PSActionRetryCount je také použit v příkazu.
PSActionRunningTimeoutSec <Int32>
Určuje, jak dlouho může aktivita běžet na každém cílovém počítači. Pokud se aktivita nedokončí před vypršením časového limitu, pracovní postup Windows PowerShell vygeneruje ukončující chybu a zastaví zpracování pracovního postupu v ovlivněném cílovém počítači.
PSAllowRedirection <Boolean>
Hodnota $True umožňuje přesměrování připojení k cílovým počítačům. Hodnota $False nemá žádný vliv. Tento společný parametr aktivity je také běžným parametrem pracovního postupu.
Při použití parametru PSConnectionURI může vzdálený cíl vrátit pokyn k přesměrování na jiný identifikátor URI. Ve výchozím nastavení Windows PowerShell nepřesměrovává připojení, ale můžete použít parametr PSAllowRedirection s hodnotou $True a povolit přesměrování připojení k cílovému počítači.
Počet přesměrování připojení můžete také omezit nastavením vlastnosti $PSSessionOption
MaximumConnectionRedirectionCount proměnné předvolby nebo vlastnosti MaximumConnectionRedirectionCount hodnoty parametru SSessionOption rutin, které vytvářejí relaci. Výchozí hodnota je 5.
PSApplicationName <String>
Určuje segment názvu aplikace identifikátoru URI připojení, který se používá pro připojení k cílovým počítačům. Tento parametr použijte k zadání názvu aplikace, pokud v příkazu nepoužíváte parametr ConnectionURI. Tento společný parametr aktivity je také běžným parametrem pracovního postupu.
Výchozí hodnota je hodnota $PSSessionApplicationName
proměnné předvoleb v cílovém počítači. Pokud tato proměnná předvoleb není definována, výchozí hodnota je WSMAN. Tato hodnota je vhodná pro většinu použití. Další informace najdete v tématu about_Preference_Variables.
Služba WinRM používá název aplikace k výběru naslouchacího procesu pro obsluhu žádosti o připojení. Hodnota tohoto parametru by se měla shodovat s hodnotou vlastnosti URLPrefix naslouchacího procesu ve vzdáleném počítači.
PSAuthentication <AuthenticationMechanism>
Určuje mechanismus, který se používá k ověření přihlašovacích údajů uživatele při připojování k cílovým počítačům. Platné hodnoty jsou Default, Basic, Credssp, Digest, Kerberos, Negotiate a NegotiateWithImplicitCredential. Výchozí hodnota je Výchozí. Tento společný parametr aktivity je také běžným parametrem pracovního postupu.
Informace o hodnotách tohoto parametru najdete v popisu výčtu System.Management.Automation.Runspaces.AuthenticationMechanism v MSDN.
Upozornění
Ověřování credSSP (Credential Security Service Provider), při kterém se přihlašovací údaje uživatele předávají vzdálenému počítači k ověření, je určeno pro příkazy, které vyžadují ověření na více než jednom prostředku, jako je například přístup ke vzdálené síťové složce. Tento mechanismus zvyšuje bezpečnostní riziko vzdálené operace. Pokud dojde k ohrožení zabezpečení vzdáleného počítače, mohou být k řízení síťové relace použity přihlašovací údaje, které jsou mu předány.
PSCertificateThumbprint <String>
Určuje certifikát digitálního veřejného klíče (X509) uživatelského účtu, který má oprávnění k provedení této akce. Zadejte kryptografický otisk certifikátu. Tento společný parametr aktivity je také společným parametrem pracovního postupu.
Certifikáty se používají při ověřování na základě klientských certifikátů. Mohou být mapovány pouze na místní uživatelské účty; nefungují s doménovými účty.
Pokud chcete získat certifikát, použijte rutiny Get-Item nebo Get-ChildItem na jednotce Windows PowerShell Cert: .
PSComputerName <String[]>
Určuje cílové počítače, na kterých se aktivita spouští. Výchozí hodnotou je místní počítač. Tento společný parametr aktivity je také společným parametrem pracovního postupu.
Do seznamu odděleného čárkami zadejte název rozhraní NETBIOS, IP adresu nebo plně kvalifikovaný název domény jednoho nebo více počítačů. Chcete-li zadat místní počítač, zadejte název počítače, "localhost" nebo tečku (.).
Pokud chcete zahrnout místní počítač do hodnoty parametru PSComputerName, otevřete Windows PowerShell s možností Spustit jako správce.
Pokud je tento parametr v příkazu vynechán nebo je hodnota $null nebo prázdný řetězec, cíl pracovního postupu je místní počítač a Windows PowerShell vzdálené komunikace se ke spuštění příkazu nepoužívá.
Pokud chcete použít IP adresu v hodnotě parametru ComputerName, musí příkaz obsahovat parametr PSCredential. Počítač také musí být nakonfigurovaný pro přenos HTTPS nebo IP adresa vzdáleného počítače musí být zahrnuta v seznamu Důvěryhodných hostitelů WinRM na místním počítači. Pokyny pro přidání názvu počítače do seznamu TrustedHosts najdete v části How to Add a Computer to the Trusted Host List (Přidání počítače do seznamu důvěryhodných hostitelů) v about_Remote_Troubleshooting.
Řetězec PSConfigurationName <>
Určuje konfigurace relací, které se používají k vytvoření relací na cílových počítačích. Zadejte název konfigurace relace na cílových počítačích (ne na počítači, na kterém běží pracovní postup. Výchozí hodnota je Microsoft.PowerShell. Tento společný parametr aktivity je také společným parametrem pracovního postupu.
PSConnectionRetryCount <UInt>
Určuje maximální počet pokusů o připojení ke každému cílovému počítači, pokud se první pokus o připojení nezdaří. Zadejte číslo od 1 do 4 294 967 295 (UInt.MaxValue). Výchozí hodnota nula (0) představuje žádné pokusy o opakování. Tento společný parametr aktivity je také společným parametrem pracovního postupu.
PSConnectionRetryIntervalSec <UInt>
Určuje prodlevu mezi opakovanými pokusy o připojení v sekundách. Výchozí hodnota je nula (0). Tento parametr je platný pouze v případě, že hodnota PSConnectionRetryCount je alespoň 1. Tento společný parametr aktivity je také společným parametrem pracovního postupu.
PSConnectionURI <System.Uri>
Určuje identifikátor URI (Uniform Resource Identifier), který definuje koncový bod připojení pro aktivitu v cílovém počítači. Identifikátor URI musí být plně kvalifikovaný. Tento společný parametr aktivity je také společným parametrem pracovního postupu.
Formát tohoto řetězce je následující:
<Transport>://<ComputerName>:<Port>/<ApplicationName>
Výchozí hodnota je https://localhost:5985/WSMAN
.
Pokud nezadáte PSConnectionURI, můžete k zadání hodnot PSConnectionURI použít parametry PSUseSSL, PSComputerName, PSPort a PSApplicationName.
Platné hodnoty pro segment Transport v identifikátoru URI jsou HTTP a HTTPS. Pokud zadáte identifikátor URI připojení se segmentem Přenos, ale nezadáte port, vytvoří se relace se standardními porty: 80 pro HTTP a 443 pro HTTPS. Pokud chcete pro Windows PowerShell vzdálené komunikace použít výchozí porty, zadejte port 5985 pro HTTP nebo 5986 pro HTTPS.
Přihlašovací údaje <PSCredential>
Určuje uživatelský účet, který má oprávnění ke spuštění aktivity na cílovém počítači. Ve výchozím nastavení je to aktuální uživatel. Tento parametr je platný pouze v případě, že je parametr PSComputerName zahrnutý v příkazu. Tento společný parametr aktivity je také společným parametrem pracovního postupu.
Zadejte uživatelské jméno, například User01 nebo Domain01\User01, nebo zadejte proměnnou, která obsahuje objekt PSCredential, například ten, který vrátí rutina Get-Credential. Pokud zadáte jenom uživatelské jméno, zobrazí se výzva k zadání hesla.
PSDebug <PSDataCollection[DebugRecord]>
Přidá zprávy ladění z aktivity do zadané kolekce záznamů ladění namísto zápisu zpráv ladění do konzoly nebo do hodnoty vlastnosti Debug úlohy pracovního postupu. Zprávy ladění z více aktivit můžete přidat do stejného objektu kolekce záznamů ladění.
Chcete-li použít tento společný parametr aktivity, pomocí rutiny New-Object vytvořte objekt PSDataCollection s typem DebugRecord a uložte objekt do proměnné. Pak použijte proměnnou jako hodnotu parametru PSDebug jedné nebo více aktivit, jak je znázorněno v následujícím příkladu.
Workflow Test-Workflow
{
$debugCollection = New-Object -Type `
System.Management.Automation.PSDataCollection[System.Management.Automation.DebugRecord]
InlineScript {\Server01\Share01\Get-AssetData.ps1} -PSDebug $debugCollection -Debug $True
InlineScript {\Server01\Share01\Set-AssetData.ps1} -PSDebug $debugCollection -Debug $True
if ($debugCollection -like "Missing") { ...}
}
PSDisableSerialization <Logická hodnota>
Nasměruje aktivitu tak, aby vracela "živé" (ne serializované) objekty do pracovního postupu. Výsledné objekty mají metody i vlastnosti, ale při vytvoření kontrolního bodu je nelze uložit.
PSDisableSerializationPreference <Logická hodnota>
Použije ekvivalent parametru PSDisableSerialization pro celý pracovní postup, nejen pro aktivitu. Přidání tohoto parametru se obecně nedoporučuje, protože pracovní postup, který ne serializuje své objekty, nelze obnovit ani zachovat.
Platné hodnoty:
(Výchozí) Pokud je vynechán a také jste nepřidali parametr PSDisableSerialization do aktivity, objekty jsou serializovány.
$True
. Směruje všechny aktivity v rámci pracovního postupu tak, aby vracely "živé" (nikoli serializované) objekty. Výsledné objekty mají metody i vlastnosti, ale při vytvoření kontrolního bodu je nelze uložit.$False
. Objekty pracovního postupu jsou serializovány.
PSError <PSDataCollection[ErrorRecord]>
Přidá chybové zprávy z aktivity do zadané kolekce záznamů o chybách namísto zápisu chybových zpráv do konzoly nebo do hodnoty Vlastnosti Error úlohy pracovního postupu. Chybové zprávy z více aktivit můžete přidat do stejného objektu shromažďování záznamů o chybách.
Pokud chcete použít tento společný parametr aktivity, pomocí New-Object
rutiny vytvořte objekt PSDataCollection s typem ErrorRecord a uložte objekt do proměnné. Pak proměnnou použijte jako hodnotu parametru PSError jedné nebo více aktivit, jak je znázorněno v následujícím příkladu.
Workflow Test-Workflow
{
$typeName = "System.Management.Automation.PSDataCollection"
$typeName += '[System.Management.Automation.ErrorRecord]'
$ec = New-Object $typeName
InlineScript {\Server01\Share01\Get-AssetData.ps1} -PSError $ec
InlineScript {\Server01\Share01\Set-AssetData.ps1} -PSError $ec
if ($ec.Count -gt 2)
{
# Do Some Work.
}
}
PSPersist <Logická hodnota>
Vytvoří kontrolní bod po aktivitě. Tento kontrolní bod je navíc ke všem kontrolním bodům zadaným v pracovním postupu. Tento společný parametr aktivity je také společným parametrem pracovního postupu.
"Kontrolní bod" nebo "bod trvalosti" je snímek stavu pracovního postupu a dat, která jsou zachycena během běhu pracovního postupu a jsou uložena do úložiště trvalosti na disku. Windows PowerShell Pracovní postup používá uložená data k obnovení pozastaveného nebo přerušeného pracovního postupu od posledního bodu trvalosti, nikoli k restartování pracovního postupu.
Platné hodnoty:
(Výchozí) Pokud tento parametr vynecháte, nepřidají se žádné kontrolní body. Kontrolní body se vytváří na základě nastavení pracovního postupu.
$True
. Vytvoří kontrolní bod po dokončení aktivity. Tento kontrolní bod je navíc ke všem kontrolním bodům zadaným v pracovním postupu.$False
. Nepřidávají se žádné kontrolní body. Kontrolní body se vezmou jenom v případech, kdy jsou zadané v pracovním postupu.
PSPort <Int32>
Určuje síťový port na cílových počítačích. Výchozí porty jsou 5985 (port WinRM pro HTTP) a 5986 (port WinRM pro HTTPS). Tento společný parametr aktivity je také společným parametrem pracovního postupu.
Pokud je to nutné, nepoužívejte parametr PSPort. Port nastavený v příkazu se vztahuje na všechny počítače nebo relace, na kterých se příkaz spouští. Alternativní nastavení portu může bránit spuštění příkazu na všech počítačích. Před použitím alternativního portu musíte nakonfigurovat naslouchací proces WinRM na vzdáleném počítači tak, aby naslouchal na tomto portu.
PSProgress <PSDataCollection[ProgressRecord]>
Přidá zprávy o průběhu z aktivity do zadané kolekce záznamů o průběhu namísto zápisu zpráv o průběhu do konzoly nebo do hodnoty vlastnosti Průběh úlohy pracovního postupu. Do stejného objektu shromažďování záznamů o průběhu můžete přidat zprávy o průběhu z více aktivit.
Řetězec PSProgressMessage <>
Určuje popis aktivity. Hodnota PSProgressMessage se zobrazí na indikátoru průběhu při spuštění pracovního postupu. Pokud je displayName také součástí příkazu, zobrazí se obsah indikátoru průběhu ve <formátu DisplayName>:<PSProgressMessage> .
Tento parametr je zvlášť užitečný pro identifikaci aktivit v bloku skriptu ForEach -Parallel. Bez této zprávy jsou aktivity ve všech paralelních větvích identifikovány stejným názvem.
PSRemotingBehavior <RemotingBehavior>
Určuje, jak se spravuje vzdálené komunikace při spuštění aktivity na cílových počítačích. Výchozí je PowerShell.
Platné hodnoty jsou:
Žádné: Aktivita se nespustí na vzdálených počítačích.
PowerShell: ke spuštění aktivity v cílových počítačích se používá Windows PowerShell vzdálené komunikace.
Vlastní: Aktivita podporuje svůj vlastní typ vzdálené komunikace. Tato hodnota je platná, pokud rutina implementovaná jako aktivita nastaví hodnotu atributu RemotingCapability na SupportedByCommand a příkaz obsahuje parametr ComputerName.
PSRequiredModules <String[]>
Před spuštěním příkazu importuje zadané moduly. Zadejte názvy modulů. Moduly musí být nainstalovány v cílovém počítači.
Moduly, které jsou nainstalovány v cestě zadané v proměnné prostředí PSModulePath, se automaticky importují při prvním použití libovolného příkazu v modulu. Tento parametr použijte k importu modulů, které nejsou v umístění PSModulePath.
Vzhledem k tomu, že každá aktivita v pracovním postupu běží ve vlastní relaci, importuje příkaz Import-Module modul pouze do relace, ve které běží. Neimportuje modul do relací, ve kterých běží jiné aktivity.
PSSessionOption <PSSessionOption>
Nastaví upřesňující možnosti pro relace na cílové počítače. Zadejte objekt PSSessionOption, například objekt, který vytvoříte pomocí rutiny New-PSSessionOption. Tento společný parametr aktivity je také běžným parametrem pracovního postupu.
Výchozí hodnoty pro možnosti relace jsou určeny hodnotou $PSSessionOption
proměnné předvoleb, pokud je nastavená. V opačném případě relace použije hodnoty zadané v konfiguraci relace.
Popis možností relace, včetně výchozích hodnot, najdete v tématu nápovědy k rutině New-PSSessionOption New-PSSessionOption.
Další informace o proměnné předvoleb $PSSessionOption najdete v tématu about_Preference_Variables.
PSUseSSL <Boolean>
Hodnota $True používá protokol SSL (Secure Sockets Layer) k navázání připojení k cílovému počítači. Ve výchozím nastavení se protokol SSL nepoužívá. Hodnota $False nemá žádný vliv. Tento společný parametr aktivity je také běžným parametrem pracovního postupu.
WS-Management šifruje veškerý Windows PowerShell obsah přenášený přes síť. UseSSL je dodatečná ochrana, která odesílá data přes HTTPS místo http. Pokud použijete tento parametr, ale ssl není k dispozici na portu použitém pro příkaz, příkaz selže.
PSVerbose <PSDataCollection[VerboseRecord]>
Přidá podrobné zprávy z aktivity do zadané kolekce podrobných záznamů místo zápisu podrobných zpráv do konzoly nebo do hodnoty vlastnosti Verbose úlohy pracovního postupu. Do stejného objektu kolekce podrobných záznamů můžete přidat podrobné zprávy z více aktivit.
PSWarning <PSDataCollection[WarningRecord]>
Přidá varovné zprávy z aktivity do zadané kolekce záznamů upozornění namísto zápisu zpráv upozornění do konzoly nebo do hodnoty Vlastnosti Warning úlohy pracovního postupu. Do stejného objektu shromažďování záznamů upozornění můžete přidat zprávy upozornění z více aktivit.
Výsledek
Tento parametr je platný pouze v pracovních postupech XAML.
UseDefaultInput <Logická hodnota>
Přijímá všechny vstupy pracovního postupu jako vstup do aktivity podle hodnoty.
Například aktivita Get-Process v následujícím ukázkovém pracovním postupu používá společný parametr aktivity UseDefaultInput k získání vstupu, který je předán do pracovního postupu. Když spustíte pracovní postup se vstupem, použije se tento vstup aktivitou.
workflow Test-Workflow
{
Get-Service -UseDefaultInput $True
}
PS C:> Test-Workflow -InputObject WinRm
Status Name DisplayName PSComputerName
------ ---- ----------- --------------
Running winrm Windows Remote Management (WS-Manag... localhost
<Podrobný přepínačParameter>
Zobrazí podrobné informace o operaci provedené příkazem. Tyto informace se podobají informacím v trasování nebo v transakčním protokolu. Parametr Verbose přepíše hodnotu proměnné $VerbosePreference aktuálního příkazu. Tento parametr funguje pouze v případě, že příkaz vygeneruje podrobnou zprávu. Tento parametr je také Windows PowerShell společný parametr.
WarningAction <ActionPreference>
Určuje, jak aktivita reaguje na upozornění. "Pokračovat" je výchozí hodnota. Parametr WarningAction přepíše hodnotu proměnné $WarningPreference aktuálního příkazu. Tento parametr funguje pouze v případě, že příkaz vygeneruje zprávu upozornění. Tento parametr je také Windows PowerShell společný parametr.
Platné hodnoty:
TišePokračovat. Potlačí zprávu upozornění a pokračuje v provádění příkazu.
Pokračovat. Zobrazí zprávu upozornění a pokračuje v provádění příkazu. "Pokračovat" je výchozí hodnota.
Dotazem. Zobrazí zprávu upozornění a před pokračováním v provádění zobrazí výzvu k potvrzení. Tato hodnota se používá zřídka.
Stop. Zobrazí zprávu upozornění a zastaví provádění příkazu.
Poznámka
Parametr WarningAction nepřepíše hodnotu proměnné předvolby $WarningAction, pokud se parametr používá v příkazu ke spuštění skriptu nebo funkce.
PŘÍKLADY
Společné parametry aktivity jsou velmi užitečné. Například můžete použít parametr PSComputerName ke spouštění konkrétních aktivit pouze na podmnožině cílových počítačů.
Nebo můžete použít parametry PSConnectionRetryCount a PSConnectionRetryIntervalSec k úpravě hodnot opakování pro konkrétní aktivity.
Následující příklad ukazuje, jak použít společné parametry aktivity PSComputerName ke spuštění aktivity Get-EventLog pouze na počítačích s konkrétní doménou.
Workflow Test-Workflow
{
$UserDomain = Get-Content -Path '.\UserComputers.txt'
$Log = (Get-EventLog -LogName "Windows PowerShell" `
-PSComputerName $UserDomain)
if ($Log)
{
# Do Work Here.
}
}