about_WorkflowCommonParameters

Cikk
03/21/2024

RÖVID LEÍRÁS

Ez a témakör az összes Windows PowerShell-munkafolyamat-parancsra érvényes paramétereket ismerteti. Mivel a Windows PowerShell-motor hozzáadja őket a munkafolyamatokhoz, ezeket a paramétereket bármely munkafolyamaton használhatja, és azok automatikusan engedélyezve lesznek a létrehozott munkafolyamatokon.

HOSSZÚ LEÍRÁS

A Windows PowerShell-munkafolyamat gyakori paraméterei olyan parancsmagparaméterek, amelyeket az összes Windows PowerShell-munkafolyamathoz és -tevékenységhez használhat. Ezeket a Windows PowerShell munkafolyamat-motorja, nem pedig a munkafolyamat szerzője adva hozzá, és automatikusan elérhetővé válnak munkafolyamatokon és tevékenységeken. A háromszintű mélybe ágyazott munkafolyamatok azonban nem támogatják a gyakori paramétereket, beleértve a munkafolyamatok gyakori paramétereit sem.

Minden munkafolyamat-paraméter választható és elnevezett (nem pozíció). Nem vesznek fel bemenetet a folyamatból.

A munkafolyamat gyakori paramétereinek többsége előtaggal PS rendelkezik, például PSComputerName és PSCredential. A PS-előtagú paraméterek konfigurálják a kapcsolatot és a végrehajtási környezetet a célszámítógépekhez, más néven "távoli csomópontokhoz".

A munkafolyamat számos gyakori paramétere, például a PSAllowRedirection és az AsJob, olyan névvel rendelkezik, amelyek hasonlóak a Windows PowerShell-újraírásban és a háttérfeladatokban használt paraméterekhez. Ezek a paraméterek ugyanúgy működnek, mint a hasonlóan elnevezett átnevezési és feladatparaméterek, így a munkafolyamatok kezeléséhez használhatja az átnevezés és a feladatok során kifejlesztett tudást.

A munkafolyamatokat a Windows PowerShell 3.0-ban vezetjük be.

PARAMÉTERLEÍRÁSOK

Ez a szakasz a munkafolyamat gyakori paramétereit ismerteti.

-AsJob <SwitchParameter>

Munkafolyamat-feladatként futtatja a munkafolyamatot. A munkafolyamat-parancs azonnal visszaad egy szülőfeladatot jelképező objektumot. A szülőfeladat az egyes célszámítógépeken futó gyermekfeladatokat tartalmazza. A feladat kezeléséhez használja a Feladat parancsmagokat. A feladat eredményeinek lekéréséhez használja a Fogadó feladat lehetőséget.

-JobName sztring <>

A munkafolyamat-feladat rövid nevét adja meg. A feladatok Job<n><n> neve alapértelmezés szerint egy sorszám.

Ha egy munkafolyamat-parancsban a JobName paramétert használja, a munkafolyamat feladatként fut, és a munkafolyamat-parancs egy feladatobjektumot ad vissza, még akkor is, ha nem tartalmazza az AsJob paramétert a parancsban.

További információ a Windows PowerShell háttérfeladatairól: about_Jobs.

-PSAllowRedirection <SwitchParameter>

Lehetővé teszi a kapcsolat átirányítását a célszámítógépek felé.

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 használatával 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 a beállítási változó Maximum Csatlakozás ionRedirectionCount tulajdonságának $PSSessionOption vagy a PSSessionOption paraméter értékének Maximum Csatlakozás ionRedirectionCount tulajdonságának beállításával is korlátozhatja. Az alapértelmezett érték 5. További információkért tekintse meg a PSSessionOption paraméter és a New-PSSessionOption leírását.

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

Az alapértelmezett érték a helyi számítógépen található $PSSessionApplicationName beállítási változó értéke. Ha ez a beállításváltozó nincs definiálva, az alapértelmezett érték az 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ők:

Default
Basic
Credssp
Digest
Kerberos
Negotiate
NegotiateWithImplicitCredential

Az alapértelmezett érték Default.

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.

-PSAuthenticationLevel <AuthenticationLevel>

Megadja a célszámítógépekkel létesített kapcsolatok hitelesítési szintjét. Az alapértelmezett érték Default.

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

Név	Leírás
`Unchanged`	A hitelesítési szint megegyezik az előző paranccsal.
`Default`	Windows-hitelesítés.
`None`	Nincs COM-hitelesítés.
`Connect`	Csatlakozás szintű COM-hitelesítés.
`Call`	Hívásszintű COM-hitelesítés.
`Packet`	Csomagszintű COM-hitelesítés.
`PacketIntegrity`	Csomagintegritási szintű COM-hitelesítés.
`PacketPrivacy`	Csomag adatvédelmi szintű COM-hitelesítése.

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

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[]>

Megadja a munkafolyamat célcsomópontjait tartalmazó számítógépek listáját. A munkafolyamatok parancsai vagy tevékenységei a paraméterrel megadott számítógépeken futnak. Alapértelmezés szerint a helyi számítógép.

Í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 a munkamenet-konfigurációkat, amelyek a célszámítógépeken futó munkamenetek konfigurálásához használatosak. Adjon meg egy munkamenet-konfigurációt a célszámítógépeken (nem a munkafolyamat-kiszolgáló számítógépén). Az alapértelmezett beállítás a Microsoft.PowerShell.Workflow.

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

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

-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ép munkafolyamatának kapcsolati végpontját. Az URI-nak teljes mértékben minősítettnek kell lennie.

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

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

-P Standard kiadás lapsedTimeoutSec <UInt32>

Meghatározza, hogy mennyi ideig tart fenn a munkafolyamat és az összes kapcsolódó erőforrás a rendszerben. Az időtúllépés lejártakor a munkafolyamat akkor is törlődik, ha még feldolgozás alatt áll. Adjon meg egy 10 és 4 294 967 295 közötti értéket. Az alapértelmezett érték ( 0 nulla) azt jelenti, hogy nincs eltelt időtúllépés.

-PSParameterCollection <Hashtable[]>

Különböző munkafolyamatok gyakori paraméterértékeit adja meg a különböző célszámítógépekhez.

Adja meg a vesszővel tagolt kivonattáblák listáját minden célszámítógéphez egy kivonattáblával. Minden kivonattáblában az első kulcs a PSComputerName , értéke pedig a célszámítógép neve. A számítógép nevében helyettesítő karakterek használhatók. A kivonatoló táblában lévő fennmaradó kulcsok esetében a kulcs a paraméter neve, az érték pedig a paraméter értéke.

Példa:

-PSParameterCollection @{PSComputerName="*"; PSElapsedTimeoutSec=20},
@{PSComputerName="Server02"},
@{PSComputerName="Server03"},
@{PSComputerName="Server01"; PSElapsedTimeoutSec=10}

A fenti példában minden kapcsolat alapértelmezett P Standard kiadás lapsedTimeoutSec másodpercben 20 lesz, kivéve a Server01-et, amely felülírja az alapértelmezett értéket a saját másodperces időtúllépésének 10 megadásával.

-PSPersist <logikai>

Ellenőrzőpontokat ad hozzá a munkafolyamathoz a munkafolyamatban megadott ellenőrzőpontokon kívül.

Ez a paraméter nem tilthatja le a munkafolyamat ellenőrzőpontjait, például a PSPersist tevékenység közös paramétere, a Checkpoint-Workflow tevékenység vagy a $PSPersistPreference változó használatával megadottakat.

Az "ellenőrzőpont" vagy "adatmegőrzési pont" a munkafolyamat állapotának és adatainak pillanatképe, amely a munkafolyamat futtatásakor lesz rögzítve, és a rendszer lemezen vagy SQL-adatbázisban lévő adatmegőrzési tárolóba menti. 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 egy ellenőrzőpontot ad hozzá a munkafolyamat elejéhez és végéhez a munkafolyamatban megadott ellenőrzőpontok mellett.
$True. Ellenőrzőpontot ad hozzá a munkafolyamat elejéhez és végéhez, valamint egy ellenőrzőpontot minden tevékenység után, a munkafolyamatban megadott ellenőrzőpontok mellett.
$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 5986 (a HTTPS WinRM-portja).

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.

-PSPrivateMetadata <hashtable>

Testre szabott információkat biztosít a munkafolyamat-feladatokhoz. Adjon meg egy kivonattáblát. A kulcsok és értékek minden munkafolyamathoz testre vannak szabva. A munkafolyamat privát metaadataival kapcsolatos információkért tekintse meg a munkafolyamat súgótémakörét.

Ezt a paramétert a Windows PowerShell munkafolyamat-motorja nem dolgozza fel. Ehelyett a motor közvetlenül a munkafolyamatnak továbbítja a kivonattáblát.

-PSRunningTimeoutSec <UInt32>

A munkafolyamat futási idejét adja meg másodpercek alatt, kivéve a munkafolyamat felfüggesztésének időpontját. Ha a munkafolyamat végrehajtása nem fejeződik be az idő lejártakor, a Windows PowerShell munkafolyamat-motorja kényszerítve leállítja a munkafolyamat végrehajtását.

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

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ások leírását, beleértve az alapértelmezett értékeket, tekintse meg a New-PSSessionOption című témakört. A beállítási változóval kapcsolatos információkért $PSSessionOption lásd : about_Preference_Variables.

-PSUseSSL <SwitchParameter>

A Secure Sockets Layer (SSL) protokoll használatával létesít kapcsolatot a célszámítógéppel. Alapértelmezés szerint az SSL nem használatos.

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.