Sdílet prostřednictvím

about_ActivityCommonParameters

  • Článek

KRÁTKÝ POPIS

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

DLOUHÝ POPIS

Pracovní postup Windows PowerShellu přidá společné parametry aktivity do aktivit odvozených ze základní třídy PSActivity . Tato kategorie zahrnuje inlinescriptovou aktivitu a rutiny Prostředí Windows PowerShell implementované jako aktivity, například Get-Process a Get-WinEvent.

Běžné parametry aktivity nejsou platné pro Suspend-Workflow aktivity a Checkpoint-Workflow nejsou přidány do rutin nebo výrazů, které pracovní postup Windows PowerShellu automaticky spouští v bloku inlineScript skriptu nebo podobné aktivitě. Běžné parametry aktivity jsou k dispozici pro aktivitu InlineScript , ale ne pro příkazy 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 běžných parametrech pracovního postupu najdete v tématu about_WorkflowCommonParameters. Informace o běžných parametrech Windows PowerShellu najdete v tématu 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 skriptu 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
}

Ladění <parametru SwitchParameter>

Zobrazí podrobnosti na úrovni programátora o operaci prováděné příkazem. Parametr Debug přepíše hodnotu $DebugPreference proměnné 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.

DisplayName <String>

Určuje popisný název aktivity. Hodnota DisplayName se zobrazí na indikátoru průběhu, zatímco se pracovní postup spustí a v hodnotě vlastnosti Průběh úlohy pracovního postupu. Pokud je parametr PSProgressMessage také součástí příkazu, obsah indikátoru průběhu se zobrazí ve <DisplayName>:<PSProgressMessage> formátu.

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 jenom v případě, že příkaz vygeneruje neukončující chybu, například chybu z rutiny Write-Error . Parametr ErrorAction přepíše hodnotu $ErrorActionPreference proměnné pro aktuální příkaz. Tento parametr je také běžným parametrem Windows PowerShellu.

Platné hodnoty:

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

  • Ignore. Potlačí chybovou zprávu a pokračuje v provádění příkazu. Na rozdíl od SilentlyContinue, Ignore nepřidá chybovou $Error zprávu do automatické proměnné. Hodnota Ignore se zavádí ve Windows PowerShellu 3.0.

  • Inquire. 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.

  • Suspend. 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.

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

  • Stop. 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 $False nemá žádný vliv. Tento parametr použijte s paralelními a ForEach -Parallel klíčovými slovy ke shromažďování chyb a výstupu z několika paralelních příkazů v jedné kolekci.

PSActionRetryCount <Int32>

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

PSActionRetryIntervalSec <Int32>

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

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 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.

Pokud použijete parametr PS Připojení ionURI, vzdálený cíl může vrátit instrukce pro 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 povolení 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 Maximum Připojení ionRedirectionCount proměnné předvolby nebo vlastnosti Maximum Připojení ionRedirectionCount hodnoty parametru SessionOption 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 určení názvu aplikace, pokud v příkazu nepoužíváte parametr Připojení ionURI. 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 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, DigestCredSSPKerberos, , 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 System.Management.Automation.Runspaces.AuthenticationMechanism výčet v sadě PowerShell SDK.

Upozorňující

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 PowerShellu Cert: .

PSComputerName <String[]>

Určuje cílové počítače, na kterých se aktivita spouští. Ve výchozím nastavení je to 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 localhostpočítače nebo tečku (.).

Pokud chcete zahrnout místní počítač do hodnoty parametru PSComputerName , otevřete Prostředí Windows PowerShell s možností Spustit jako správce .

Pokud je tento parametr z příkazu vynechán, nebo je $null hodnota nebo prázdný řetězec, cíl pracovního postupu je místní počítač a vzdálené komunikace Prostředí Windows PowerShell 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č 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 k přidání názvu počítače do seznamu TrustedHosts najdete 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 na cílových počítačích (ne v počítači, na kterém běží pracovní postup). Výchozí hodnota je Microsoft.PowerShell.Workflow. Tento společný parametr aktivity je také běžným parametrem pracovního postupu.

PS Připojení ionRetryCount <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 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.

PS Připojení ionRetryIntervalSec <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 PS Připojení ionRetryCount je alespoň 1. Tento společný parametr aktivity je také běžným parametrem pracovního postupu.

PS Připojení ionURI <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 http://localhost:5985/WSMAN.

Pokud nezadáte ps Připojení ionURI, můžete k určení hodnot PS Připojení ionURI použít parametry PSUseSSL, PSComputerName, PSPort a PSApplicationName.

Platné hodnoty pro transportní segment 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 HTTPS. Pokud chcete použít výchozí porty pro vzdálené komunikace Prostředí Windows PowerShell, zadejte port 5985 pro PROTOKOL HTTP nebo 5986 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. Ve výchozím nastavení je to aktuální uživatel. Tento parametr je platný pouze v případě, že parametr PSComputerName je součástí příkazu. Tento společný parametr aktivity je také běžným parametrem pracovního postupu.

Zadejte uživatelské jméno, například User01 nebo Domain01\User01nebo zadejte proměnnou , která obsahuje objekt PSCredential , například takové, které rutina Get-Credential vrátí. 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í místo zápisu ladicí zprávy 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-Objectk vytvoření PSDataCollection objektu s typem DebugRecord a uložte objekt do proměnné. Pak proměnnou použijte 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 pro celý pracovní postup, nejen 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 tento parametr vynecháte 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é" (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[ErrorRecord]>

Přidá chybové zprávy z aktivity do zadané kolekce záznamů chyb mí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-Objectk vytvoření PSDataCollection objektu 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.
   }
}

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>

Určuje síťový port na cílových počítačích. Výchozí porty jsou 5985 (port WinRM pro HTTP) a 59'86 (port WinRM pro HTTPS). Tento společný parametr aktivity je také běžným parametrem pracovního postupu.

Nepoužívejte parametr PSPort, pokud 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 zadané kolekce záznamů průběhu místo zápisu zpráv 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ů 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 během spuštění pracovního postupu zobrazí na indikátoru průběhu. Pokud je v příkazu zahrnutý i displayName, zobrazí se obsah indikátoru průběhu ve <DisplayName>:<PSProgressMessage> formátu.

Tento parametr je zvlášť užitečný pro identifikaci aktivit v ForEach -Parallel bloku skriptu. 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 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:

  • None: Aktivita není spuštěna na vzdálených počítačích.

  • PowerShell: Vzdálené komunikace prostředí Windows PowerShell slouží ke spuštění aktivity na cílových počítačích.

  • Custom: Aktivita podporuje 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 nainstalované 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, Import-Module příkaz importuje modul pouze do relace, ve které běží. 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 objekt, který vytvoříte pomocí rutinyNew-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 $PSSessionOption proměnné předvoleb najdete v tématu 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 mí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 zadané podrobné kolekce záznamů místo zápisu podrobných zpráv do konzoly nebo do hodnoty podrobné vlastnosti ú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á zprávy upozornění z aktivity do zadané kolekce záznamů upozornění místo zápisu zpráv upozornění do konzoly nebo do hodnoty Warning vlastnost ú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 Get-Process aktivita v následujícím ukázkovém pracovním postupu používá společný parametr aktivity UseDefaultInput k získání vstupu předaného 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. Podrobný parametr přepíše hodnotu $VerbosePreference proměnné 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í. Continue je výchozí hodnota. Parametr WarningAction přepíše hodnotu $WarningPreference proměnné 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:

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

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

  • Inquire. 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.

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

Poznámka:

Parametr WarningAction nepřepíše hodnotu $WarningAction proměnné předvolby, 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é. Pomocí parametru PSComputerName můžete například spouštět konkrétní aktivity pouze na podmnožině cílových počítačů.

Nebo můžete použít parametry PS Připojení ionRetryCount a PS Připojení ionRetryIntervalSec k úpravě hodnot opakování pro konkrétní aktivity.

Následující příklad ukazuje, jak používat běžné parametry aktivity PSComputerName ke spuštění Get-EventLog aktivity pouze na počítačích, které je 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.
    }
}

Viz také