Megosztás a következőn keresztül:

about_ActivityCommonParameters

  • Cikk

RÖVID LEÍRÁS

A Windows PowerShell-munkafolyamat által a tevékenységekhez hozzáadott paramétereket ismerteti.

HOSSZÚ LEÍRÁS

A Windows PowerShell-munkafolyamat hozzáadja a tevékenység gyakori paramétereit a PSActivity alaposztályból származó tevékenységekhez. Ebbe a kategóriába tartoznak az InlineScript-tevékenységek és a tevékenységekként implementált Windows PowerShell-parancsmagok, például Get-Process és Get-WinEvent.

A tevékenység gyakori paraméterei nem érvényesek a tevékenységekre és Checkpoint-Workflow tevékenységekreSuspend-Workflow, és nem lesznek hozzáadva azokhoz a parancsmagokhoz vagy kifejezésekhez, amelyeket a Windows PowerShell-munkafolyamat automatikusan futtat egy InlineScript-szkriptblokkban vagy hasonló tevékenységben. A tevékenység gyakori paraméterei az InlineScript-tevékenységben érhetők el, de az InlineScript-szkriptblokk parancsaiban nem.

Számos gyakori tevékenységparaméter a munkafolyamat gyakori paraméterei vagy a Windows PowerShell gyakori paraméterei. A tevékenységek egyéb gyakori paraméterei egyediek a tevékenységekre.

A munkafolyamat gyakori paramétereiről további információt a about_WorkflowCommonParameters talál. A Windows PowerShell gyakori paramétereiről további információt a about_CommonParameters talál.

A TEVÉKENYSÉG GYAKORI PARAMÉTEREINEK LISTÁJA

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

PARAMÉTERLEÍRÁSOK

Ez a szakasz a tevékenység gyakori paramétereit ismerteti.

AppendOutput <logikai>

Egy érték $True hozzáadja a tevékenység kimenetét a változó értékéhez. Egy értéknek $False nincs hatása. Alapértelmezés szerint egy érték változóhoz való hozzárendelése lecseréli a változó értékét.

Az alábbi parancsok például hozzáadnak egy folyamatobjektumot a változó szolgáltatásobjektumához $x .

Workflow Test-Workflow
{
    $x = Get-Service
    $x = Get-Process -AppendOutput $true
}

Ez a paraméter XAML-alapú munkafolyamatokhoz lett tervezve. Szkript-munkafolyamatokban a += hozzárendelési operátorral is hozzáadhat kimenetet egy változó értékéhez, ahogyan az az alábbi példában is látható.

Workflow Test-Workflow
{
    $x = Get-Service
    $x += Get-Process
}

SwitchParameter hibakeresése <>

A parancs által végrehajtott művelet programozói szintű részleteit jeleníti meg. A Hibakeresés paraméter felülbírálja az $DebugPreference aktuális parancs változójának értékét. Ez a paraméter csak akkor működik, ha a parancs hibakeresési üzeneteket hoz létre. Ez a paraméter a Windows PowerShell gyakori paramétere is.

DisplayName <karakterlánc>

A tevékenység rövid nevét adja meg. A DisplayName érték megjelenik a folyamatsávon a munkafolyamat futtatása közben, valamint a munkafolyamat-feladat Folyamat tulajdonságának értékében. Ha a PSProgressMessage paraméter is szerepel a parancsban, a folyamatjelző sáv tartalma formátumban <DisplayName>:<PSProgressMessage> jelenik meg.

ErrorAction <ActionPreference>

Meghatározza, hogy a tevékenység hogyan reagál a parancs nem végződő hibájára. Nincs hatással a megszüntetési hibákra. Ez a paraméter csak akkor működik, ha a parancs nem végződő hibát okoz, például a Write-Error parancsmagból származókat. Az ErrorAction paraméter felülbírálja az $ErrorActionPreference aktuális parancs változójának értékét. Ez a paraméter a Windows PowerShell gyakori paramétere is.

Érvényes értékek:

  • Continue. Megjeleníti a hibaüzenetet, és folytatja a parancs végrehajtását. Continue az alapértelmezett érték.

  • Ignore. Letiltja a hibaüzenetet, és folytatja a parancs végrehajtását. Ellentétben SilentlyContinueaz automatikus változóval, Ignore nem adja hozzá a $Error hibaüzenetet. Az Ignore érték a Windows PowerShell 3.0-ban lesz bevezetve.

  • Inquire. Megjeleníti a hibaüzenetet, és megerősítést kér a végrehajtás folytatása előtt. Ezt az értéket ritkán használják.

  • Suspend. Automatikusan felfüggeszt egy munkafolyamat-feladatot, hogy lehetővé tegye a további vizsgálatot. A vizsgálat után a munkafolyamat folytatható.

  • SilentlyContinue. Letiltja a hibaüzenetet, és folytatja a parancs végrehajtását.

  • Stop. Megjeleníti a hibaüzenetet, és leállítja a parancs végrehajtását.

Bemeneti <objektum[]>

Objektumgyűjteményt küld egy tevékenységnek. Ez egy alternatíva arra, hogy az objektumokat egyenként pipaozza a tevékenységhez.

MergeErrorToOutput <logikai érték>

Egy érték hibát $True ad hozzá a kimeneti streamhez. Egy értéknek $False nincs hatása. Ezt a paramétert a Parallel és ForEach -Parallel a kulcsszavak használatával egyetlen gyűjtemény több párhuzamos parancsából származó hibák és kimenetek gyűjtéséhez használhatja.

PSActionRetryCount <Int32>

Ha az első kísérlet meghiúsul, többször is megpróbálja futtatni a tevékenységet. Az alapértelmezett érték nem 0próbálkozik újra.

PSActionRetryIntervalSec <Int32>

Meghatározza az újrapróbálkozások közötti időközt másodpercben. Az alapértelmezett érték azonnal 0újrapróbálkozza a műveletet. Ez a paraméter csak akkor érvényes, ha a PSActionRetryCount paramétert is használja a parancs.

PSActionRunningTimeoutSec <Int32>

Meghatározza, hogy a tevékenység mennyi ideig futhat az egyes célszámítógépeken. Ha a tevékenység nem fejeződik be az időtúllépés lejárta előtt, a Windows PowerShell-munkafolyamat leállítja a hibát, és leállítja a munkafolyamat feldolgozását az érintett célszámítógépen.

PSAllowRedirection <logikai>

Egy érték $True lehetővé teszi a kapcsolat átirányítását a célszámítógépek felé. Egy értéknek $False nincs hatása. Ez a tevékenység gyakori paramétere a munkafolyamat gyakori paramétere is.

A PS Csatlakozás ionURI paraméter használatakor a távoli cél egy utasítást adhat vissza egy másik URI-ra való átirányításhoz. A Windows PowerShell alapértelmezés szerint nem irányítja át a kapcsolatokat, de a PSAllowRedirection paraméter értéke $True lehetővé teszi a kapcsolat átirányítását a célszámítógépre.

A kapcsolat átirányításának számát a beállítási változó Maximum Csatlakozás ionRedirectionCount tulajdonságának $PSSessionOption vagy a munkamenetet létrehozó parancsmagok SessionOption paraméterének Maximum Csatlakozás ionRedirectionCount tulajdonságának beállításával is korlátozhatja. Az alapértelmezett érték 5.

PSApplicationName <karakterlánc>

Megadja a célszámítógépekhez való csatlakozáshoz használt kapcsolati URI alkalmazásnév-szegmensét. Ezzel a paraméterrel adhatja meg az alkalmazás nevét, ha nem használja a Csatlakozás ionURI paramétert a parancsban. Ez a tevékenység gyakori paramétere a munkafolyamat gyakori paramétere is.

Az alapértelmezett érték a célszámítógépen található $PSSessionApplicationName beállítási változó értéke. Ha ez a beállítási változó nincs definiálva, az alapértelmezett érték a WSMAN. Ez az érték a legtöbb felhasználáshoz megfelelő. További információ: about_Preference_Variables.

A WinRM szolgáltatás az alkalmazás nevével választ ki egy figyelőt a kapcsolatkérés kiszolgálásához. A paraméter értékének meg kell egyeznie a távoli számítógépen lévő figyelő URLPrefix tulajdonságának értékével.

PSAuthentication <AuthenticationMechanism>

Megadja a felhasználó hitelesítő adatainak hitelesítéséhez használt mechanizmust a célszámítógépekhez való csatlakozáskor. Az érvényes értékek a következőkDefault: , Basic, CredSSPDigest, Kerberos, Negotiateés NegotiateWithImplicitCredential. Az alapértelmezett érték Default. Ez a tevékenység gyakori paramétere a munkafolyamat gyakori paramétere is.

A paraméter értékeivel kapcsolatos információkért tekintse meg a System.Management.Automation.Runspaces.AuthenticationMechanism enumerálás leírását a PowerShell SDK-ban.

Figyelmeztetés

A hitelesítő adatok biztonsági szolgáltatójának (CredSSP) hitelesítése, amelyben a felhasználó hitelesítő adatai egy hitelesítendő távoli számítógépre kerülnek, olyan parancsokhoz készült, amelyek több erőforráson is hitelesítést igényelnek, például távoli hálózati megosztáshoz való hozzáféréshez. Ez a mechanizmus növeli a távoli művelet biztonsági kockázatát. Ha a távoli számítógép biztonsága sérül, a neki átadott hitelesítő adatokkal szabályozható a hálózati munkamenet.

PSCertificateThumbprint sztring <>

Egy olyan felhasználói fiók digitális nyilvános kulcsú tanúsítványát (X509) adja meg, amely jogosult a művelet végrehajtására. Adja meg a tanúsítvány ujjlenyomatát. Ez a tevékenység gyakori paramétere a munkafolyamat gyakori paramétere is.

A tanúsítványok az ügyféltanúsítvány-alapú hitelesítésben használatosak. Ezek csak helyi felhasználói fiókokhoz rendelhetők le; nem működnek tartományi fiókokkal.

Tanúsítvány beszerzéséhez használja a Get-Item vagy a Get-ChildItem parancsmagokat a Windows PowerShell-meghajtónCert:.

PSComputerName <karakterlánc[]>

Meghatározza azokat a célszámítógépeket, amelyeken a tevékenység fut. Alapértelmezés szerint a helyi számítógép. Ez a tevékenység gyakori paramétere a munkafolyamat gyakori paramétere is.

Írja be egy vagy több számítógép NETBIOS-nevét, IP-címét vagy teljes tartománynevét egy vesszővel tagolt listában. A helyi számítógép megadásához írja be a számítógép nevét vagy localhostpontját (.).

Ha fel szeretné venni a helyi számítógépet a PSComputerName paraméter értékére, nyissa meg a Windows PowerShellt a Futtatás rendszergazdaként lehetőséggel.

Ha ez a paraméter nincs megadva a parancsból, vagy az $null érték vagy egy üres sztring, a munkafolyamat-cél a helyi számítógép, és a Windows PowerShell-remoting nem használható a parancs futtatásához.

Ha IP-címet szeretne használni a ComputerName paraméter értékében, a parancsnak tartalmaznia kell a PSCredential paramétert. Emellett a számítógépet HTTPS-átvitelre kell konfigurálni, vagy a távoli számítógép IP-címét fel kell venni a helyi számítógép WinRM TrustedHosts listájába. A számítógépnév TrustedHosts-listához való hozzáadására vonatkozó utasításokért tekintse meg a about_Remote_Troubleshooting "Számítógép hozzáadása a megbízható gazdagéplistához" című témakört.

PSConfigurationName <karakterlánc>

Megadja azokat a munkamenet-konfigurációkat, amelyek a célszámítógépeken munkamenetek létrehozásához szükségesek. Adja meg a munkamenet-konfiguráció nevét a célszámítógépeken (nem a munkafolyamatot futtató számítógépen). Az alapértelmezett beállítás a Microsoft.PowerShell.Workflow. Ez a tevékenység gyakori paramétere a munkafolyamat gyakori paramétere is.

PS Csatlakozás ionRetryCount <UInt>

Az egyes célszámítógépekhez való kapcsolódási kísérletek maximális számát adja meg, ha az első csatlakozási kísérlet meghiúsul. Adjon meg egy 1 és 4 294 967 295 közötti számot (UInt.MaxValue). Az alapértelmezett nulla (0) érték nem jelent újrapróbálkozási kísérleteket. Ez a tevékenység gyakori paramétere a munkafolyamat gyakori paramétere is.

PS Csatlakozás ionRetryIntervalSec <UInt>

A kapcsolat újrapróbálkozási kísérletei közötti késleltetést adja meg másodpercben. Az alapértelmezett érték nulla (0). Ez a paraméter csak akkor érvényes, ha a PS Csatlakozás ionRetryCount értéke legalább 1. Ez a tevékenység gyakori paramétere a munkafolyamat gyakori paramétere is.

PS Csatlakozás ionURI <System.Uri>

Egy egységes erőforrás-azonosítót (URI) ad meg, amely meghatározza a célszámítógépen végzett tevékenység kapcsolati végpontját. Az URI-nak teljes mértékben minősítettnek kell lennie. Ez a tevékenység gyakori paramétere a munkafolyamat gyakori paramétere is.

A sztring formátuma a következő:

<Transport>://<ComputerName>:<Port>/<ApplicationName>

Az alapértelmezett érték http://localhost:5985/WSMAN.

Ha nem ad meg PS Csatlakozás ionURI-t, a PSUseSSL, a PSComputerName, a PSPort és a PSApplicationName paraméterekkel megadhatja a PS Csatlakozás ionURI-értékeket.

Az URI átviteli szegmensének érvényes értékei a következők HTTP : és HTTPS. Ha egy átviteli szegmenshez tartozó kapcsolati URI-t ad meg, de nem ad meg portot, a munkamenet szabványportokkal jön létre: 80 HTTP-hez és 443 HTTPS-hez. A Windows PowerShell-remoting alapértelmezett portjának használatához adja meg a HTTP vagy 5986 a HTTPS portot5985.

PSCredential <PSCredential>

Olyan felhasználói fiókot ad meg, amely jogosult a tevékenység futtatására a célszámítógépen. Alapértelmezés szerint az aktuális felhasználó. Ez a paraméter csak akkor érvényes, ha a PSComputerName paraméter szerepel a parancsban. Ez a tevékenység gyakori paramétere a munkafolyamat gyakori paramétere is.

Írjon be egy felhasználónevet, például User01 vagy Domain01\User01írjon be egy PSCredential objektumot tartalmazó változót, például azt, amelyet a Get-Credential parancsmag visszaad. Ha csak felhasználónevet ad meg, a rendszer jelszót kér.

PSDebug <PSDataCollection[DebugRecord]>

Hibakeresési üzeneteket ad hozzá a tevékenységtől a megadott hibakeresési rekordgyűjteményhez, ahelyett, hogy a hibakeresési üzeneteket a konzolra vagy a munkafolyamat-feladat Hibakeresés tulajdonságának értékére íratja. Több tevékenységből származó hibakeresési üzeneteket is hozzáadhat ugyanahhoz a hibakeresési rekordgyűjtemény-objektumhoz.

A tevékenység gyakori paraméterének használatához a New-Object parancsmaggal hozzon létre egy PSDataCollection objektumot a DebugRecord típusával, és mentse az objektumot egy változóba. Ezután használja a változót egy vagy több tevékenység PSDebug paraméterének értékeként az alábbi példában látható módon.

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

A tevékenység "élő" (nem szerializált) objektumok visszaadására irányítja a munkafolyamatot. Az eredményül kapott objektumok metódusokkal és tulajdonságokkal rendelkeznek, de ellenőrzőpont létrehozásakor nem menthetők.

PSDisableSerializationPreference <boolean>

A PSDisableSerialization paraméter megfelelője a teljes munkafolyamatra vonatkozik, nem csak a tevékenységre. A paraméter hozzáadása általában nem ajánlott, mert az objektumait nem szerializáló munkafolyamatok nem folytathatók és nem tárolhatók.

Érvényes értékek:

  • (Alapértelmezett) Ha nincs megadva, és a PSDisableSerialization paramétert sem adta hozzá egy tevékenységhez, az objektumok szerializálva lesznek.

  • $True. A munkafolyamaton belüli összes tevékenységet "élő" (nem szerializált) objektumok visszaadására irányítja. Az eredményül kapott objektumok metódusokkal és tulajdonságokkal rendelkeznek, de ellenőrzőpont létrehozásakor nem menthetők.

  • $False. A munkafolyamat-objektumok szerializáltak.

P Standard kiadás rror <PSDataCollection[ErrorRecord]>

Hibaüzeneteket ad hozzá a tevékenységtől a megadott hibarekord-gyűjteményhez ahelyett, hogy a hibaüzeneteket a konzolra vagy a munkafolyamat-feladat Hiba tulajdonságának értékére íratja. Több tevékenységből származó hibaüzeneteket is hozzáadhat ugyanahhoz a hibarekordgyűjtemény-objektumhoz.

A tevékenység gyakori paraméterének használatához a New-Object parancsmaggal hozzon létre egy PSDataCollection objektumot egy ErrorRecord típussal, és mentse az objektumot egy változóba. Ezután használja a változót egy vagy több tevékenység P Standard kiadás rror paraméterének értékeként az alábbi példában látható módon.

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

A tevékenység után ellenőrzőpontot vesz fel. Ez az ellenőrzőpont a munkafolyamatban megadott ellenőrzőpontokon kívül van. Ez a tevékenység gyakori paramétere a munkafolyamat gyakori paramétere is.

Az "ellenőrzőpont" vagy "adatmegőrzési pont" a munkafolyamat állapotának és adatainak pillanatképe, amelyet a rendszer rögzít a munkafolyamat futtatásakor, és amelyet a rendszer a lemezen lévő adatmegőrzési tárolóba ment. A Windows PowerShell-munkafolyamat a mentett adatokkal folytatja a felfüggesztett vagy megszakított munkafolyamatot az utolsó adatmegőrzési pontról ahelyett, hogy újraindítaná a munkafolyamatot.

Érvényes értékek:

  • (Alapértelmezett) Ha kihagyja ezt a paramétert, a rendszer nem ad hozzá ellenőrzőpontokat. Az ellenőrzőpontok a munkafolyamat beállításai alapján jönnek létre.

  • $True. A tevékenység befejezése után ellenőrzőpontot vesz fel. Ez az ellenőrzőpont a munkafolyamatban megadott ellenőrzőpontokon kívül van.

  • $False. A rendszer nem ad hozzá ellenőrzőpontokat. Az ellenőrzőpontok csak akkor lesznek megadva, ha a munkafolyamatban meg vannak adva.

PSPort <Int32>

A célszámítógépek hálózati portjának megadása. Az alapértelmezett portok 5985 (a HTTP WinRM-portja) és az 59'86 (a HTTPS WinRM-portja). Ez a tevékenység gyakori paramétere a munkafolyamat gyakori paramétere is.

Csak akkor használja a PSPort paramétert, ha kötelező. A parancsban beállított port minden olyan számítógépre vagy munkamenetre vonatkozik, amelyen a parancs fut. Egy másik portbeállítás megakadályozhatja, hogy a parancs minden számítógépen fusson. Egy másik port használata előtt konfigurálnia kell a WinRM-figyelőt a távoli számítógépen az adott port figyelésére.

PSProgress <PSDataCollection[ProgressRecord]>

A folyamatjelző üzeneteket a tevékenységből hozzáadja a megadott folyamatrekord-gyűjteményhez, ahelyett, hogy a folyamatjelző üzeneteket a konzolra vagy a munkafolyamat-feladat Folyamat tulajdonságának értékére íratja. Több tevékenység folyamatjelző üzeneteit is hozzáadhatja ugyanahhoz a folyamatrekord-gyűjteményobjektumhoz.

PSProgressMessage sztring <>

A tevékenység rövid leírását adja meg. A PSProgressMessage érték megjelenik a folyamatjelző sávon a munkafolyamat futtatása közben. Ha a DisplayName is szerepel a parancsban, a folyamatjelző sáv tartalma formátumban <DisplayName>:<PSProgressMessage> jelenik meg.

Ez a paraméter különösen hasznos egy szkriptblokk tevékenységeinek ForEach -Parallel azonosításához. Az üzenet nélkül az összes párhuzamos ág tevékenységeit ugyanaz a név azonosítja.

PSRemotingBehavior <RemotingBehavior>

Meghatározza, hogyan történik az átnevezés kezelése, ha a tevékenység célszámítógépeken fut. A PowerShell az alapértelmezett.

Az érvényes értékek a következők:

  • None: A tevékenység nem távoli számítógépeken fut.

  • PowerShell: A Windows PowerShell-remoting a tevékenység célszámítógépeken való futtatására szolgál.

  • Custom: A tevékenység támogatja a saját típusú újraírást. Ez az érték akkor érvényes, ha a tevékenységként implementált parancsmag a RemotingCapability attribútum értékét a SupportedByCommand értékre állítja, és a parancs tartalmazza a ComputerName paramétert.

PSRequiredModules <sztring[]>

A parancs futtatása előtt importálja a megadott modulokat. Adja meg a modulneveket. A modulokat a célszámítógépre kell telepíteni.

A PSModulePath környezeti változóban megadott elérési úton telepített modulok automatikusan importálódnak a modul bármely parancsának első használatakor. Ezzel a paraméterrel olyan modulokat importálhat, amelyek nem PSModulePath-helyen találhatók.

Mivel egy munkafolyamat minden tevékenysége a saját munkamenetében fut, a Import-Module parancsok csak abba a munkamenetbe importálják a modult, amelyben fut. Nem importálja a modult olyan munkamenetekbe, amelyeken más tevékenységek futnak.

PSSessionOption <PSSessionOption>

A munkamenetek speciális beállításait a célszámítógépekre állítja be. Adjon meg egy PSSessionOption objektumot, például egy olyan objektumot, amelyet a New-PSSessionOption parancsmaggal hoz létre. Ez a tevékenység gyakori paramétere a munkafolyamat gyakori paramétere is.

A munkamenet-beállítások alapértelmezett értékeit a beállítási változó értéke $PSSessionOption határozza meg, ha be van állítva. Ellenkező esetben a munkamenet a munkamenet-konfigurációban megadott értékeket használja.

A munkamenet beállításainak leírását, beleértve az alapértelmezett értékeket, tekintse meg a New-PSSessionOption parancsmag New-PSSessionOption parancsmagjának súgótémakörét.

A beállítási változóval kapcsolatos további információkért $PSSessionOption lásd : about_Preference_Variables.

PSUseSSL <logikai>

Egy érték $True a Secure Sockets Layer (SSL) protokoll használatával hoz létre kapcsolatot a célszámítógéppel. Alapértelmezés szerint az SSL nem használatos. Egy értéknek $False nincs hatása. Ez a tevékenység gyakori paramétere a munkafolyamat gyakori paramétere is.

A WS-Management a hálózaton keresztül továbbított összes Windows PowerShell-tartalmat titkosítja. A UseSSL egy további védelem, amely HTTP helyett HTTPS-kapcsolaton keresztül küldi el az adatokat. Ha ezt a paramétert használja, de az SSL nem érhető el a parancshoz használt porton, a parancs meghiúsul.

PSVerbose <PSDataCollection[VerboseRecord]>

Részletes üzeneteket ad hozzá a tevékenységtől a megadott részletes rekordgyűjteményhez ahelyett, hogy a részletes üzeneteket a konzolra vagy a munkafolyamat-feladat Részletes tulajdonságának értékére íranak. Több tevékenységből származó részletes üzeneteket is hozzáadhat ugyanahhoz a részletes rekordgyűjtemény-objektumhoz.

PSWarning <PSDataCollection[WarningRecord]>

A tevékenységből származó figyelmeztető üzeneteket ad hozzá a megadott figyelmeztető rekordgyűjteményhez ahelyett, hogy a figyelmeztető üzeneteket a konzolra vagy a munkafolyamat-feladat Figyelmeztetés tulajdonságának értékére íratja. Több tevékenységből származó figyelmeztető üzeneteket is hozzáadhat ugyanahhoz a figyelmeztető rekordgyűjtemény-objektumhoz.

Eredmény

Ez a paraméter csak XAML-munkafolyamatokban érvényes.

UseDefaultInput <logikai érték>

Minden munkafolyamat-bemenetet elfogad a tevékenység bemeneteként érték szerint.

Az alábbi minta-munkafolyamatban végzett tevékenység például Get-Process a UseDefaultInput tevékenység közös paraméterét használja a munkafolyamatnak átadott bemenet lekéréséhez. Amikor bemenettel futtatja a munkafolyamatot, a tevékenység ezt a bemenetet használja.

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

<Részletes kapcsolóparaméter>

Részletes információkat jelenít meg a parancs által végrehajtott műveletről. Ez az információ hasonlít a nyomkövetésben vagy a tranzakciónaplóban szereplő információkra. A Részletes paraméter felülbírálja az $VerbosePreference aktuális parancs változójának értékét. Ez a paraméter csak akkor működik, ha a parancs részletes üzenetet hoz létre. Ez a paraméter a Windows PowerShell gyakori paramétere is.

WarningAction <ActionPreference>

Meghatározza, hogy a tevékenység hogyan reagál egy figyelmeztetésre. Continue az alapértelmezett érték. A WarningAction paraméter felülírja az $WarningPreference aktuális parancs változójának értékét. Ez a paraméter csak akkor működik, ha a parancs figyelmeztető üzenetet hoz létre. Ez a paraméter a Windows PowerShell gyakori paramétere is.

Érvényes értékek:

  • SilentlyContinue. Letiltja a figyelmeztető üzenetet, és folytatja a parancs végrehajtását.

  • Continue. Megjeleníti a figyelmeztető üzenetet, és folytatja a parancs végrehajtását. Continue az alapértelmezett érték.

  • Inquire. Megjeleníti a figyelmeztető üzenetet, és megerősítést kér a végrehajtás folytatása előtt. Ezt az értéket ritkán használják.

  • Stop. Megjeleníti a figyelmeztető üzenetet, és leállítja a parancs végrehajtását.

Feljegyzés

A WarningAction paraméter nem bírálja felül a $WarningAction beállítási változó értékét, ha a paramétert parancsban használják szkript vagy függvény futtatásához.

PÉLDÁK

A tevékenység gyakori paraméterei rendkívül hasznosak. A PSComputerName paraméterrel például futtathat bizonyos tevékenységeket a célszámítógépek csak egy részhalmazán.

Vagy használhatja a PS Csatlakozás ionRetryCount és a PS Csatlakozás ionRetryIntervalSec paramétereket az adott tevékenységek újrapróbálkozási értékeinek módosításához.

Az alábbi példa bemutatja, hogyan használhatja a PSComputerName tevékenység gyakori paramétereit egy Get-EventLog tevékenység futtatásához csak az adott tartományhoz tartozó számítógépeken.

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

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

Kapcsolódó információk