New-PSWorkflowSession
Munkafolyamat-munkamenetet hoz létre.
Syntax
Default (Alapértelmezett)
New-PSWorkflowSession
[[-ComputerName] <String[]>]
[-Credential <Object>]
[-Name <String[]>]
[-Port <Int32>]
[-UseSSL]
[-ApplicationName <String>]
[-ThrottleLimit <Int32>]
[-SessionOption <PSSessionOption>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[-EnableNetworkAccess]
[<CommonParameters>]
Description
A New-PSWorkflowSession parancsmag létrehoz egy felhasználó által felügyelt munkamenetet (PSSession), amelyet kifejezetten Windows PowerShell-munkafolyamatok futtatására terveztek. A Microsoft.PowerShell.Workflow munkamenet-konfigurációt használja, amely szkripteket, típus- és formázási fájlokat, valamint a munkafolyamatokhoz szükséges beállításokat tartalmaz.
Használhatja New-PSWorkflowSession vagy aliasát, nwsn.
A parancshoz gyakran használt munkafolyamat-paramétereket is hozzáadhat. A munkafolyamat gyakori paramétereiről további információt a about_WorkflowCommonParameters
Ezt a parancsmagot a Windows PowerShell 3.0-ban vezettük be.
Példák
1. példa: Munkafolyamat létrehozása távoli számítógépen
Ez a példa létrehozza a WorkflowTests munkamenetet a ServerNode01 távoli számítógépen.
$params = @{
ComputerName = "ServerNode01"
Name = "WorkflowTests"
SessionOption = (New-PSSessionOption -OutputBufferingMode Drop)
}
New-PSWorkflowSession @params
A SessionOption paraméter értéke egy New-PSSessionOption parancs, amely a munkamenet kimeneti pufferelési módját Dropértékre állítja.
2. példa: Munkafolyamat-munkamenetek létrehozása több távoli számítógépen
Ez a példa munkafolyamat-munkameneteket hoz létre a ServerNode01 és a Server12 számítógépeken. A parancs a Hitelesítő adatok paramétert használja a tartományi rendszergazda engedélyeivel való futtatáshoz.
"ServerNode01", "Server12" |
New-PSWorkflowSession -Name WorkflowSession -Credential Domain01\Admin01 -ThrottleLimit 150
A parancs a ThrottleLimit paraméter használatával 150-re növeli a parancsonkénti szabályozási korlátot. Ez az érték elsőbbséget élvez a Microsoft.PowerShell.Workflow munkamenetkonfigurációjában beállított alapértelmezett 100-as korlátnál.
Paraméterek
-ApplicationName
Megadja a kapcsolati URI alkalmazásnév-szegmensét.
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. 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.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-Authentication
Megadja a felhasználói hitelesítő adatok hitelesítéséhez használt mechanizmust. A paraméter elfogadható értékei a következők:
- Alapértelmezett
- Alapszintű
- Credssp
- Összefoglaló
- Kerberos
- Tárgyal
- Tárgyalás Beágyazott Hitelesítő Adattal
Az alapértelmezett érték az Alapértelmezett.
A CredSSP-hitelesítés csak a Windows Vista, a Windows Server 2008 és a Windows operációs rendszer újabb verzióiban érhető el.
A paraméter értékeivel kapcsolatos további információkért lásd AuthenticationMechanism Enumeration.
Figyelmeztetés
A hitelesítő adatok biztonsági szolgáltatójának (CredSSP) hitelesítése, amelyben a felhasználói hitelesítő adatok átadva vannak egy hitelesítendő távoli számítógépnek, 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.
Paramétertulajdonságok
| Típus: | AuthenticationMechanism |
| Alapértelmezett érték: | Default |
| Elfogadott értékek: | Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-CertificateThumbprint
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ókokra képezhetők le; nem működnek tartományi fiókokkal.
Tanúsítvány ujjlenyomatának lekéréséhez használja a Get-Item parancsmagot vagy a Windows PowerShell Cert: meghajtó Get-ChildItem parancsmagját.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-ComputerName
Állandó kapcsolatot (PSSession) hoz létre a megadott számítógéppel. Ha több számítógépnevet ad meg, a Windows PowerShell több PSSessionshoz létre, egyet minden számítógéphez. Az alapértelmezett beállítás a helyi számítógép.
Írja be egy vagy több távoli számítógép NetBIOS-nevét, IP-címét vagy teljes tartománynevét. 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 számítógép más tartományban van, mint a felhasználó, a teljes tartománynévre van szükség. A számítógép nevét idézőjelekkel is beszűkítheti a New-PSWorkflowSession.
Ha IP-címet szeretne használni a ComputerName paraméter értékében, a parancsnak tartalmaznia kell a Hitelesítő adatok 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.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | Local computer |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Cn |
Paraméterkészletek
(All)
| Position: | 0 |
| Kötelező: | False |
| Folyamatból származó érték: | True |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-Credential
A művelet végrehajtásához engedéllyel rendelkező felhasználói fiókot ad meg. Az alapértelmezett az aktuális felhasználó. Írjon be egy felhasználónevet (például User01, Domain01\User01 vagy User@Domain.com), vagy írjon be egy PSCredential objektumot, például a Get-Credential parancsmag által visszaadott objektumot.
Felhasználónév beírásakor ez a parancsmag jelszó megadását kéri.
Paramétertulajdonságok
| Típus: | Object |
| Alapértelmezett érték: | Current user |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-EnableNetworkAccess
Azt jelzi, hogy ez a parancsmag egy interaktív biztonsági jogkivonatot ad hozzá a visszacsatolási munkamenetekhez. Az interaktív jogkivonat segítségével parancsokat futtathat a visszacsatolási munkamenetben, amelyek adatokat kapnak más számítógépekről. Futtathat például egy parancsot a munkamenetben, amely XML-fájlokat másol egy távoli számítógépről a helyi számítógépre.
A visszacsatolási munkamenet egy PSSession, amely ugyanabból a számítógépről származik és végződik. Visszacsatolási munkamenet létrehozásához ne adja meg a ComputerName paramétert, és ne állítsa az értékét pontra, localhostra vagy a helyi számítógép nevére.
Alapértelmezés szerint olyan visszacsatolási munkamenetek jönnek létre, amelyek hálózati jogkivonattal rendelkeznek, amelyek esetleg nem biztosítanak elegendő engedélyt a távoli számítógépek hitelesítéséhez.
Az EnableNetworkAccess paraméter csak visszacsatolási munkamenetekben érvényes. Ha az EnableNetworkAccess paramétert adja meg, amikor munkamenetet hoz létre egy távoli számítógépen, a parancs sikeres lesz, de a paraméter figyelmen kívül lesz hagyva.
A visszacsatolási munkamenetekben a távelérést a Hitelesítési paraméter CredSSP értékével is engedélyezheti, amely a munkamenet hitelesítő adatait más számítógépekre delegálja.
A számítógép rosszindulatú hozzáférés elleni védelme érdekében az interaktív jogkivonatokkal rendelkező leválasztott visszacsatolási munkamenetek, amelyek az EnableNetworkAccess paraméter használatával lettek létrehozva, csak attól a számítógéptől csatlakoztathatók újra, amelyen a munkamenet létrejött. A CredSSP-hitelesítést használó leválasztott munkamenetek újra csatlakoztathatók más számítógépekről. További információ: Disconnect-PSSession parancsmag.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Name
A munkafolyamat-munkamenet rövid nevét adja meg. A nevet más parancsmagokkal is használhatja, például Get-PSSession és Enter-PSSession. A névnek nem kell egyedinek lennie a számítógépen vagy az aktuális munkamenetben.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | Session# |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Port
A kapcsolathoz használt hálózati portot adja meg a távoli számítógépen. Távoli számítógéphez való csatlakozáshoz a távoli számítógépnek a kapcsolat által használt portot kell figyelnie. Az alapértelmezett portok a következők: 5985 (WINRM-port HTTP-hez) és 5986 (WinRM-port HTTPS-hez).
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. A figyelő konfigurálásához használja az alábbi parancsokat:
winrm delete winrm/config/listener?Address=*+Transport=HTTP
winrm create winrm/config/listener?Address=*+Transport=HTTP @{Port="\<port-number\>"}
Ne használja a Port paramétert, hacsak nem szükséges. A parancs portbeállítása 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.
Paramétertulajdonságok
| Típus: | Int32 |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-SessionOption
A munkamenet speciális beállításait adja meg. Adjon meg egy SessionOption objektumot, például azt, amelyet a New-PSSessionOption parancsmaggal hoz létre.
A beállítások alapértelmezett értékeit a $PSSessionOption beállítási változó értéke határozza meg, ha be van állítva. Ellenkező esetben az alapértelmezett értékeket a munkamenet-konfigurációban megadott beállítások állítják be.
A munkamenet-beállításértékek elsőbbséget élveznek a $PSSessionOption beállítási változóban és a munkamenet-konfigurációban beállított munkamenetek alapértelmezett értékeivel szemben. Azonban nem elsőbbséget élveznek a munkamenet-konfigurációban beállított maximális értékekkel, kvótával vagy korlátokkal szemben. További információ a munkamenet-konfigurációkról: about_Session_Configurations.
A munkamenet beállításainak leírását, beleértve az alapértelmezett értékeket, tekintse meg a New-PSSessionOption.
A $PSSessionOption beállítási változóval kapcsolatos információkért lásd: about_Preference_Variables.
Paramétertulajdonságok
| Típus: | PSSessionOption |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-ThrottleLimit
Megadja a parancs futtatásához létrehozható egyidejű kapcsolatok maximális számát. Ha kihagyja ezt a paramétert, vagy 0 (nulla) értéket ad meg, a Microsoft.PowerShellWorkflow munkamenetkonfigurációjának alapértelmezett értéke (100).
A szabályozás korlátja csak az aktuális parancsra vonatkozik, a munkamenetre és a számítógépre nem.
Paramétertulajdonságok
| Típus: | Int32 |
| Alapértelmezett érték: | 100 |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-UseSSL
Azt jelzi, hogy ez a parancsmag a Secure Sockets Layer (SSL) protokoll használatával hoz létre kapcsolatot a távoli szá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 paraméter egy további védelem, amely HTTP-kapcsolat helyett HTTPS-kapcsolaton keresztül küldi az adatokat.
Ha megadja ezt a paramétert, de az SSL nem érhető el a parancshoz használt porton, a parancs meghiúsul.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
Bevitelek
PSSession
Erre a parancsmagra egy munkamenetet vagy egy számítógépnevet is csövezhet.
Kimenetek
PSSession
Jegyzetek
A New-PSWorkflowSession parancs egyenértékű a következő paranccsal:
New-PSSession -ConfigurationName Microsoft.PowerShell.Workflow