Sdílet prostřednictvím

O společnosti ActivityCommonParameters

KRÁTKÝ POPIS

Popisuje parametry, které pracovní postup Windows PowerShellu přidává do aktivit.

DLOUHÝ POPIS

Pracovní postup prostředí Windows PowerShell 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, například Get-Process a Get-WinEvent.

Společné parametry aktivity nejsou platné pro aktivity Suspend-Workflow a Checkpoint-Workflow a nejsou přidány do rutin nebo výrazů, které pracovní postup prostředí Windows PowerShell automaticky spouští v bloku skriptu InlineScript nebo podobné aktivitě. Společné parametry aktivity jsou k dispozici u aktivity InlineScript, ale ne u příkazů v bloku skriptu InlineScript.

Několik běžných parametrů aktivity jsou také běžné parametry pracovního postupu nebo běžné parametry Windows PowerShellu. Další společné parametry aktivity jsou jedinečné pro aktivity.

Informace o společných parametrech pracovního postupu naleznete v části about_WorkflowCommonParameters. Informace o běžných parametrech prostředí Windows PowerShell naleznete v části about_CommonParameters.

SEZNAM BĚŽ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 běžné parametry aktivity.

Boolean AppendOutput <>

Hodnota sčítá $True výstup aktivity k hodnotě proměnné. Hodnota $False nemá žá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řidávají 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é použít operátor přiřazení += k přidání výstupu 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
}

Ladění <parametru SwitchParameter>

Zobrazí podrobnosti na úrovni programátora o operaci prováděné příkazem. Parametr Debug přepíše hodnotu proměnné $DebugPreference pro aktuální příkaz. Tento parametr funguje pouze v případě, že příkaz generuje zprávy ladění. Tento parametr je také běžným parametrem Windows PowerShellu.

Řetězec DisplayName <>

Určuje popisný název aktivity. Hodnota DisplayName se zobrazí na indikátoru průběhu během běhu pracovního postupu a v hodnotě vlastnosti Progress úlohy pracovního postupu. Pokud je v příkazu zahrnut také parametr PSProgressMessage, 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 pro aktuální příkaz. Tento parametr je také běžným parametrem Windows PowerShellu.

Platné hodnoty:

  • Pokračovat. Zobrazí chybovou zprávu a pokračuje v provádění příkazu. "Pokračovat" je výchozí hodnota.

  • Ignorujte. 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 automatické proměnné $Error. Hodnota Ignore je zavedena v Windows PowerShell 3.0.

  • Informovat se. 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.

  • Přerušit. Automaticky pozastaví úlohu pracovního postupu, aby bylo možné provést další šetření. Po prošetření je možné pracovní postup obnovit.

  • TišePokračovat. Potlačí chybovou zprávu a pokračuje v provádění příkazu.

  • Zastav. Zobrazí chybovou zprávu a ukončí provádění příkazu.

Vstupní <objekt[]>

Odešle kolekci objektů do aktivity. Jedná se o alternativu k propojení objektů k aktivitě po jednom.

Logická hodnota MergeErrorToOutput <>

Hodnota sčítá chyby do výstupního $True datového proudu. Hodnota nemá $False vliv. Tento parametr použijte s klíčovými slovy Parallel a ForEach -Parallel ke shromažďování chyb a výstupu z více paralelních příkazů v jedné kolekci.

PSActionRetryCount <Int32>

Pokusí se aktivitu spustit opakovaně, pokud první pokus selže. Výchozí hodnota 0 se neopakuje.

PSActionRetryIntervalSec <Int32>

Určuje interval mezi opakovanými pokusy o akci v sekundách. Výchozí hodnota, 0, zopakuje akci okamžitě. Tento parametr je platný pouze v případě, že je v příkazu použit také parametr PSActionRetryCount.

PSActionRunningTimeoutSec <Int32 – Ovládací panel>

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 PowerShellu vygeneruje ukončující chybu a přestane zpracovávat pracovní postup 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.

Když použijete parametr PSConnectionURI , vzdálený cíl může 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 , který umožní přesměrování připojení na cílový počítač.

Počet přesměrování připojení můžete také omezit nastavením vlastnosti MaximumConnectionRedirectionCount proměnné $PSSessionOption předvoleb nebo vlastnosti MaximumConnectionRedirectionCount hodnoty parametru SSessionOption rutin, které vytvářejí relaci. Výchozí hodnota je 5.

Řetězec PSApplicationName <>

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 části about_Preference_Variables.

Služba WinRM používá název aplikace k výběru naslouchacího procesu pro službu žá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 Default. Tento společný parametr aktivity je také běžným parametrem pracovního postupu.

Informace o hodnotách tohoto parametru naleznete v popisu výčtu System.Management.Automation.Runspaces.AuthenticationMechanism na webu MSDN.

Výstraha

Ověřování zprostředkovatele služby CredSSP (Credential Security Service Provider), ve kterém jsou přihlašovací údaje uživatele předány vzdálenému počítači, který se má ověřit, je určený pro příkazy, které vyžadují ověření u více než jednoho prostředku, například pro přístup ke vzdálené síťové sdílené složce. Tento mechanismus zvyšuje riziko zabezpečení vzdálené operace. Pokud dojde k ohrožení zabezpečení vzdáleného počítače, dají se k řízení síťové relace použít 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é běžným parametrem pracovního postupu.

Certifikáty se používají při ověřování na základě klientských certifikátů. Lze je namapovat 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:.

Řetězec názvu PSComputer[ <]>

Určuje cílové počítače, na kterých se aktivita spouští. Výchozí hodnota je místní počítač. Tento společný parametr aktivity je také běžným parametrem pracovního postupu.

Do seznamu oddělených čárkami zadejte název 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 do hodnoty parametru PSComputerName zahrnout místní počítač, otevřete Windows PowerShell s možností Spustit jako správce.

Pokud je tento parametr v příkazu vynechán nebo je jeho hodnota $null nebo prázdný řetězec, cílem pracovního postupu je místní počítač a ke spuštění příkazu se nepoužívá vzdálená komunikace prostředí Windows PowerShell.

Chcete-li v hodnotě parametru ComputerName použít IP adresu, musí příkaz obsahovat parametr PSCredential. Počítač musí být také nakonfigurovaný pro přenos HTTPS nebo musí být IP adresa vzdáleného počítače zahrnuta do 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 naleznete v části Postup 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 vytváření relací v cílových počítačích. Zadejte název konfigurace relace v cílových počítačích (nikoli v počítači, na kterém je spuštěn pracovní postup. Výchozí je Microsoft.PowerShell. Tento společný parametr aktivity je také běž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 první pokus o připojení selže. Zadejte číslo v rozmezí 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é běžným parametrem pracovního postupu.

PSConnectionRetryIntervalSec <UInt>

Určuje zpoždění mezi pokusy o opakování 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é běž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é běž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 PSConnectionURI nezadáte, můžete k určení hodnot PSConnectionURI použít parametry PSUseSSL, PSComputerName, PSPort a PSApplicationName.

Platné hodnoty pro segment přenosu identifikátoru URI jsou HTTP a HTTPS. Pokud zadáte identifikátor URI připojení s přenosovým segmentem, ale nezadáte port, relace se vytvoří s porty standardů: 80 pro HTTP a 443 pro HTTPS. Pokud chcete použít výchozí porty pro vzdálené komunikace Prostředí Windows PowerShell, zadejte port 5985 pro HTTP nebo 5986 pro HTTPS.

PSCredential PSCredential <>

Určuje uživatelský účet, který má oprávnění ke spuštění aktivity v cílovém počítači. Výchozí hodnota je aktuální uživatel. Tento parametr je platný pouze v případě, že je v příkazu zahrnut parametr PSComputerName. Tento společný parametr aktivity je také běž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á ladicí zprávy z aktivity do zadané kolekce záznamů ladění namísto zápisu ladicích zpráv do konzoly nebo do hodnoty vlastnosti Debug úlohy pracovního postupu. Do stejného objektu kolekce záznamů ladění můžete přidat zprávy ladění z více aktivit.

Chcete-li použít tento společný parametr aktivity, použijte rutinu New-Object k vytvoření objektu 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") { ...}
}

Logická hodnota PSDisableSerialization <>

Nasměruje aktivitu tak, aby do pracovního postupu vrátila "živé" (ne serializované) objekty. Výsledné objekty mají metody, stejně jako vlastnosti, ale nelze je uložit při vytvoření kontrolního bodu.

PsDisableSerializationPreference <Boolean>

Použije ekvivalent parametru PSDisableSerialization na celý pracovní postup, nejen na aktivitu. Přidání tohoto parametru se obecně nedoporučuje, protože pracovní postup, který serializuje objekty, nelze obnovit ani zachovat.

Platné hodnoty:

  • (Výchozí) Pokud je tento parametr vynechán a také jste do aktivity nepřidali parametr PSDisableSerialization, objekty se serializují.

  • $True. Směruje všechny aktivity v rámci pracovního postupu tak, aby vracely "živé" (ne serializované) objekty. Výsledné objekty mají metody, stejně jako vlastnosti, ale nelze je uložit při vytvoření kontrolního bodu.

  • $False. Objekty pracovního postupu jsou serializovány.

PSError <PSDataCollection[Záznam_chyb]>

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. Do stejného objektu shromažďování záznamů chyb můžete přidat chybové zprávy z více aktivit.

Chcete-li použít tento společný parametr aktivity, použijte rutinu New-Object k vytvoření objektu PSDataCollection s typem ErrorRecord a uložte objekt do proměnné. Pak použijte proměnnou 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.
   }
}

Logická hodnota PSPersist <>

Provede kontrolní bod za aktivitou. Tento kontrolní bod je kromě všech kontrolních bodů zadaných v pracovním postupu. Tento společný parametr aktivity je také běžným parametrem pracovního postupu.

Kontrolní bod nebo bod trvalosti je snímek stavu pracovního postupu a data zachycená při spuštění pracovního postupu a ukládají se do úložiště trvalosti na disku. Pracovní postup Windows PowerShellu používá uložená data k obnovení pozastaveného nebo přerušeného pracovního postupu z posledního bodu trvalosti místo restartování pracovního postupu.

Platné hodnoty:

  • (Výchozí) Pokud tento parametr vynecháte, nepřidají se žádné kontrolní body. Kontrolní body se zavedou na základě nastavení pracovního postupu.

  • $True. Po dokončení aktivity provede kontrolní bod. Tento kontrolní bod je kromě všech kontrolních bodů zadaných v pracovním postupu.

  • $False. Nejsou přidány žádné kontrolní body. Kontrolní body jsou převzaty pouze v případech, kdy jsou zadány v pracovním postupu.

PSPort <int32 řekl:>

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é běžným parametrem pracovního postupu.

Parametr PSPort nepoužívejte, pokud to není nutné. 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 zabrá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 určené kolekce záznamů o průběhu namísto zápisu zpráv o průběhu do konzoly nebo do hodnoty vlastnosti Progress úlohy pracovního postupu. Do stejného objektu shromažďování záznamů 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 během běhu pracovního postupu. Pokud je v příkazu zahrnut také DisplayName, zobrazí se obsah indikátoru průběhu ve <formátu DisplayName>:<PSProgressMessage> .

Tento parametr je zvláště 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 <– chování vzdálené komunikace>

Určuje způsob správy vzdálené komunikace při spuštění aktivity na cílových počítačích. PowerShell je výchozí hodnota.

Platné hodnoty jsou:

  • Žádné: Aktivita se nespouští na vzdálených počítačích.

  • PowerShell: Vzdálená komunikace Windows PowerShell se používá ke spuštění aktivity na cílových počítačích.

  • Vlastní: Aktivita podporuje vlastní typ vzdálené komunikace. Tato hodnota je platná, pokud rutina, která je implementována 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 je spuštěna ve vlastní relaci, příkaz Import-Module importuje modul pouze do relace, ve které je spuštěn. Neimportuje modul do relací, ve kterých se spouští jiné aktivity.

PSSessionOption <PSSessionOption>

Nastaví upřesňující možnosti relací na cílové počítače. Zadejte objekt PSSessionOption, například ten, 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 nastavena. V opačném případě relace používá hodnoty zadané v konfiguraci relace.

Popis možností relace, včetně výchozích hodnot, najdete v tématu nápovědy pro rutinu New-PSSessionOption New-PSSessionOption.

Další informace o proměnné předvoleb $PSSessionOption naleznete v části about_Preference_Variables.

Logická hodnota PSUseSSL <>

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 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ý obsah Windows PowerShellu přenášený přes síť. UseSSL je další ochrana, která odesílá data přes protokol HTTPS namísto protokolu 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 určené podrobné kolekce záznamů namísto zápisu podrobných zpráv do konzoly nebo do hodnoty vlastnosti Podrobné úlohy pracovního postupu. Do stejného podrobného objektu kolekce 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 s upozorněním do konzoly nebo do hodnoty vlastnosti Warning úlohy pracovního postupu. Do stejného objektu kolekce 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 <Boolean>

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 pracovnímu 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č SwitchParameter>

Zobrazí podrobné informace o operaci prováděné příkazem. Tyto informace se podobají informacím v trasování nebo v transakčním protokolu. Parametr Podrobný přepíše hodnotu proměnné $VerbosePreference pro aktuální příkaz. Tento parametr funguje pouze v případě, že příkaz vygeneruje podrobnou zprávu. Tento parametr je také běžným parametrem Windows PowerShellu.

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 pro aktuální příkaz. Tento parametr funguje pouze v případě, že příkaz vygeneruje zprávu s upozorněním. Tento parametr je také běžným parametrem Windows PowerShellu.

Platné hodnoty:

  • TišePokračovat. Potlačí zprávu upozornění a pokračuje v provádění příkazu.

  • Pokračovat. Zobrazí zprávu s upozorněním a pokračuje v provádění příkazu. "Pokračovat" je výchozí hodnota.

  • Informovat se. Zobrazí zprávu s upozorněním a před pokračováním v provádění vás vyzve k potvrzení. Tato hodnota se používá zřídka.

  • Zastav. Zobrazí zprávu s upozorněním a zastaví spuštění příkazu.

Poznámka:

Parametr WarningAction nepřepíše hodnotu proměnné předvoleb $WarningAction, pokud je parametr použit v příkazu ke spuštění skriptu nebo funkce.

PŘÍKLADY

Běžné parametry aktivity jsou velmi užitečné. Můžete například použít parametr PSComputerName ke spuš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 v počítačích v konkrétní doméně.

Workflow Test-Workflow
{
    $UserDomain = Get-Content -Path '.\UserComputers.txt'
    $Log = (Get-EventLog -LogName "Windows PowerShell" `
      -PSComputerName $UserDomain)

    if ($Log)
    {
        # Do Work Here.
    }
}

VIZ TAKÉ

about_Workflowsabout_WorkflowCommonParameters

  • Last updated on