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

Az ActivityCommonParameters ismertetése

RÖVID LEÍRÁS

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

HOSSZÚ LEÍRÁS

Windows PowerShell-munkafolyamat hozzáadja a tevékenység általános paramétereit a PSActivity alaposztályból származó tevékenységekhez. Ez a kategória tartalmazza az InlineScript tevékenységet és a Windows PowerShell parancsmagokat, amelyek tevékenységként vannak megvalósítva, például a Get-Process és a Get-WinEvent.

A tevékenység közös paraméterei nem érvényesek a Suspend-Workflow és a Checkpoint-Workflow tevékenységekre, és nem adják hozzá azokat a parancsmagokat vagy kifejezéseket, amelyeket Windows PowerShell-munkafolyamat automatikusan futtat egy InlineScript-szkriptblokkban vagy hasonló tevékenységben. A tevékenység általános 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.

További információ a munkafolyamat általános paramétereiről: about_WorkflowCommonParameters. További információ a Windows PowerShell gyakori paramétereiről: about_CommonParameters.

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. A szkript-munkafolyamatokban a += hozzárendelési operátorral is hozzáadhat kimenetet egy változó értékéhez, ahogy az alábbi példában 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 Debug paraméter felülbírálja az aktuális parancs $DebugPreference 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 folyamatjelző sávon a munkafolyamat futása közben, valamint a munkafolyamat-feladat Progress tulajdonságának értékében. Ha a PSProgressMessage paraméter is szerepel a parancsban, a folyamatjelző sáv tartalma DisplayName>:<PSProgressMessage> formátumban <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 megszakító hibát generál, például a Write-Error parancsmagból. Az ErrorAction paraméter felülbírálja az aktuális parancs $ErrorActionPreference változójának értékét. Ez a paraméter a Windows PowerShell gyakori paramétere is.

Érvényes értékek:

  • Folytatódik. Megjeleníti a hibaüzenetet, és folytatja a parancs végrehajtását. A "Folytatás" az alapértelmezett érték.

  • Figyelmen kívül hagy. Letiltja a hibaüzenetet, és folytatja a parancs végrehajtását. A SilentlyContinue-tól eltérően az Ignore nem adja hozzá a hibaüzenetet a $Error automatikus változóhoz. A Figyelmen kívül hagyás érték a Windows PowerShell 3.0-ban jelenik meg.

  • Érdeklődik. 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.

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

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

  • Állj. 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. Az értéknek $False nincs hatása. Ezzel a paraméterrel a Parallel és a ForEach -Parallel kulcsszavakkal több párhuzamos parancs hibáit és kimenetét gyűjtheti egyetlen gyűjteményben.

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 (0) nem pró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 0 azonnal újrapróbálkozik a művelettel. 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>

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

A PSConnectionURI paraméter használatakor a távoli cél egy másik URI-ra való átirányításra vonatkozó utasítást adhat vissza. Alapértelmezés szerint a Windows PowerShell nem irányítja át a kapcsolatokat, de a PSAllowRedirection paraméterrel $True értékkel engedélyezheti a kapcsolat átirányítását a célszámítógépre.

A kapcsolat átirányításának számát is korlátozhatja, ha beállítja a $PSSessionOption beállításváltozó MaximumConnectionRedirectionCount tulajdonságát, vagy a munkamenetet létrehozó parancsmagok SSessionOption paraméterének értékét. 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 ConnectionURI 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ó a about_Preference_Variablescímű részben található.

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 <hitelesítési mechanizmus>

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: Default, Basic, Credssp, Digest, Kerberos, Negotiate és NegotiateWithImplicitCredential. Az alapértelmezett érték az Alapértelmezett. 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 az MSDN System.Management.Automation.Runspaces.AuthenticationMechanism enumerálásának leírását.

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 parancsmagot a Windows PowerShell Cert: meghajtón.

PSComputerName <karakterlánc[]>

Meghatározza azokat a célszámítógépeket, amelyeken a tevékenység fut. Az alapértelmezett beállítás 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, a "localhost" vagy a pont (.).

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

Ha ez a paraméter kimarad a parancsból, vagy az értéke $null vagy egy üres sztring, a munkafolyamat célja a helyi számítógép, és a Windows PowerShell távelérés 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 "Számítógép hozzáadása a megbízható gazdagéplistához" című témakört about_Remote_Troubleshooting.

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 érték a Microsoft.PowerShell. Ez a tevékenység gyakori paramétere a munkafolyamat gyakori paramétere is.

PSConnectionRetryCount <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 érték (nulla (0) nem jelent újrapróbálkozási kísérleteket. Ez a tevékenység gyakori paramétere a munkafolyamat gyakori paramétere is.

PSConnectionRetryIntervalSec <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 PSConnectionRetryCount értéke legalább 1. Ez a tevékenység gyakori paramétere a munkafolyamat gyakori paramétere is.

PSConnectionURI <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 a https://localhost:5985/WSMAN.

Ha nem ad meg PSConnectionURI értéket, a PSUseSSL, a PSComputerName, a PSPort és a PSApplicationName paraméterekkel adhatja meg a PSConnectionURI értékeket.

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

PSCredenciális <PSCredentiális>

Olyan felhasználói fiókot ad meg, amely jogosult a tevékenység futtatására a célszámítógépen. Az alapértelmezett 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", vagy adjon meg egy változót, amely tartalmaz egy PSCredential objektumot, például egy olyan változót, amelyet a Get-Credential parancsmag ad vissza. Ha csak felhasználónevet ad meg, a rendszer jelszót fog kérni.

PSDebug <PSDataCollection[DebugRecord]>

Hibakeresési üzeneteket ad hozzá a tevékenységbő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ébe írná. 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ípussal, é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, ahogy az az alábbi példában látható.

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 paraméter PSDisableSerialization megfelelőjét alkalmazza a teljes munkafolyamatra, 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 nem adta hozzá a PSDisableSerialization paramétert 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.

PSError <PSDataCollection[ErrorRecord]>

Hibaüzeneteket ad hozzá a tevékenységbő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 írná. 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 PSError paraméterének értékeként, ahogy az alábbi példában látható.

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 a következők: 5985 (HTTP WinRM-port) és 5986 (a HTTPS WinRM-portja). Ez a tevékenység gyakori paramétere a munkafolyamat gyakori paramétere is.

Ne használja a PSPort paramétert, hacsak nem muszáj. 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]>

Előrehaladási üzeneteket ad hozzá a tevékenységből a megadott folyamatrekord-gyűjteményhez ahelyett, hogy a folyamatüzeneteket a konzolra vagy a munkafolyamat-feladat Progress tulajdonságának értékébe írná. 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 futása közben. Ha a DisplayName is szerepel a parancsban, a folyamatjelző sáv tartalma DisplayName>:<PSProgressMessage> formátumban <jelenik meg.

Ez a paraméter különösen hasznos a ForEach -Parallel szkriptblokkban végzett tevékenységek 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:

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

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

  • Egyéni: A tevékenység támogatja a saját távelérési típusát. Ez az érték akkor érvényes, ha a tevékenységként megvalósított parancsmag a RemotingCapability attribútum értékét 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 útra telepített modulok importálása automatikusan történik a modul bármely parancsának első használatakor. Ezzel a paraméterrel olyan modulokat importálhat, amelyek nem PSModulePath helyen vannak.

Mivel a munkafolyamat minden tevékenysége a saját munkamenetében fut, a Import-Module parancs csak abba a munkamenetbe importálja 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 egyet, 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.

További információ a $PSSessionOption beállításváltozóról: about_Preference_Variables.

PSUseSSL <logikai>

A $True érték a Secure Sockets Layer (SSL) protokollt használja a célszámítógéppel való kapcsolat létesítéséhez. Alapértelmezés szerint az SSL nem használatos. A $False értéknek nincs hatása. Ez a tevékenység gyakori paramétere a munkafolyamat gyakori paramétere is.

WS-Management titkosítja a hálózaton keresztül továbbított összes Windows PowerShell-tartalmat. A UseSSL egy további védelem, amely HTTP helyett HTTPS-en 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égbő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ébe írná. 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]>

Figyelmeztető üzeneteket ad hozzá a tevékenységből a megadott figyelmeztető rekordgyűjteményhez ahelyett, hogy a figyelmeztető üzeneteket a konzolra vagy a munkafolyamat-feladat Figyelmeztetés tulajdonságának értékébe írná. 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-munkafolyamat Get-Process tevékenysége például 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 aktuális parancs $VerbosePreference 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.

FigyelmeztetésMűvelet <ActionPreference>

Meghatározza, hogy a tevékenység hogyan reagál egy figyelmeztetésre. A "Folytatás" az alapértelmezett érték. A WarningAction paraméter felülbírálja az aktuális parancs $WarningPreference 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:

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

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

  • Érdeklődik. 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.

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

Megjegyzés:

A WarningAction paraméter nem írja felül a $WarningAction beállításváltozó értékét, ha a paramétert parancsfájlban parancsfájl vagy függvény futtatására használják.

PÉLDÁK

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

Vagy használhatja a PSConnectionRetryCount és a PSConnectionRetryIntervalSec paramétereket az egyes tevékenységek újrapróbálkozási értékeinek módosításához.

Az alábbi példa bemutatja, hogyan használható a PSComputerName tevékenység általános paraméterei egy Get-EventLog tevékenység futtatására csak egy adott tartomány számítógépein.

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

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

LÁSD MÉG

about_Workflowsabout_WorkflowCommonParameters

  • Last updated on