Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
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 PS-előtaggal 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 PSAllowRedirection a és AsJob, a Windows PowerShell távelérési és háttérfeladatokban használt paraméterekhez hasonló névvel rendelkezik. 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. Alapértelmezés szerint a feladatok neve "Job<n>", ahol <n> egy sorszám.
Ha a JobName paramétert használja egy munkafolyamat-parancsban, a munkafolyamat feladatként fut, és a munkafolyamat-parancs egy feladatobjektumot ad vissza, még akkor is, ha a AsJob paramétert nem tartalmazza a parancsban.
További információ a Windows PowerShell háttérfeladatairól: about_Jobs.
-PSAllowÁtirányítási <kapcsolóParaméter>
Lehetővé teszi a kapcsolat átirányítását a célszámítógépek felé.
A paraméter használatakor PSConnectionURI 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 engedélyezheti a kapcsolat átirányítását a célszámítógépre.
A kapcsolat átirányításának MaximumConnectionRedirectionCount számát is korlátozhatja a $PSSessionOption beállításváltozó tulajdonságának vagy MaximumConnectionRedirectionCountPSSessionOption parametera . Az alapértelmezett érték 5. További információé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 ConnectionURI 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á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. Ennek a paraméternek az értékének meg kell egyeznie a távoli számítógépen lévő figyelő tulajdonságának értékével URLPrefix .
-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 a következők:
- Alapértelmezett
- Alapszintű
- Credssp
- Összefoglaló
- Kerberos
- Tárgyalj
- Tárgyalás implicit hitelesítő adatokkal
Az alapértelmezett érték a következő: Alapértelmezett.
A paraméter értékeiről az MSDN enumerálásának leírásában System.Management.Automation.Runspaces.AuthenticationMechanism olvashat.
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 a következő: Alapértelmezett.
Az érvényes értékek a következők:
| Név | Leírás |
|---|---|
| Változatlan | A hitelesítési szint megegyezik az előző paranccsal. |
| Alapértelmezett | Windows-hitelesítés. |
| Nincs | Nincs COM-hitelesítés. |
| Csatlakozás | Kapcsolódási szintű COM-hitelesítés. |
| Hív | Hívásszintű COM-hitelesítés. |
| Csomag | Csomagszintű COM-hitelesítés. |
| Csomagintegritás | Csomagintegritási szintű COM-hitelesítés. |
| Csomagadatvédelem | 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] (xref:Microsoft.PowerShell.Management.Get-Childitem) parancsmagot a Windows PowerShell Cert: meghajtón.
-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. Az alapértelmezett beállítás 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, 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 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ával kapcsolatos utasításokért olvassa el a about_Remote_Troubleshooting"Számítógép hozzáadása a megbízható állomások listájához" című részét.
-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 érték a Microsoft.PowerShell.Workflow.
-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.
-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.
-PSConnectionURI <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 a https://localhost:5985/WSMAN.
Ha nem ad meg egy PSConnectionURI, a , PSUseSSLPSComputerNameés a PSPort paramétereket használhatja PSApplicationNameaz értékek megadásáhozPSConnectionURI.
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áalis <PSCredentiális>
Olyan felhasználói fiókot ad meg, amely jogosult munkafolyamat 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.
Í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 egyet, amelyet a Get-Credential parancsmag ad vissza. Ha csak felhasználónevet ad meg, a rendszer jelszót fog kérni.
-PSElapsedTimeoutSec <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, a 0 (nulla) azt jelenti, hogy nincs eltelt időtúllépés.
-PSParameterCollection <kivonattábla[]>
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 PSComputerName és értéke 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éldául:
-PSParameterCollection @{PSComputerName="*"; PSElapsedTimeoutSec=20},
@{PSComputerName="Server02"},
@{PSComputerName="Server03"},
@{PSComputerName="Server01"; PSElapsedTimeoutSec=10}
A fenti példában az összes kapcsolat alapértelmezett PSElapsedTimeoutSec 20 másodperces PSElapsedTimeoutSec lesz, kivéve a Server01 értéket, amely felülbírálja az alapértelmezett értéket a saját 10 másodperces időtúllépésének 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 tudja letiltani a munkafolyamat ellenőrzőpontjait, például azokat, amelyeket a PSPersist tevékenység közös paramétere, a Checkpoint-Workflow tevékenység vagy a $PSPersistPreference változó használatával határoztak meg.
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 munkafolyamatban megadott ellenőrzőpontok mellett egy ellenőrzőpont is hozzáadódik a munkafolyamat elejéhez és végéhez.
$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 a következők: 5985 (HTTP WinRM-port) és 5986 (a HTTPS WinRM-portja).
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.
-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 objektumot PSSessionOption , például a New-PSSessionOption parancsmaggal létrehozott objektumot.
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 is) a parancsmag súgótémakörében New-PSSessionOption találja (xref:Microsoft.PowerShell.Core.New-PSSessionOption). A $PSSessionOption beállítási változóval kapcsolatos információkért lásd: about_Preference_Variables.
-PSUseSSL <kapcsolóparaméter>
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.
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.