Get-PSSession
Lekéri a Windows PowerShell-munkameneteket helyi és távoli számítógépeken.
Syntax
Name (Alapértelmezett)
Get-PSSession
[-Name <String[]>]
[<CommonParameters>]
ComputerName
Get-PSSession
[-ComputerName] <String[]>
[-ApplicationName <String>]
[-ConfigurationName <String>]
[-Name <String[]>]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[-Port <Int32>]
[-UseSSL]
[-ThrottleLimit <Int32>]
[-State <SessionFilterState>]
[-SessionOption <PSSessionOption>]
[<CommonParameters>]
ComputerInstanceId
Get-PSSession
[-ComputerName] <String[]>
-InstanceId <Guid[]>
[-ApplicationName <String>]
[-ConfigurationName <String>]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[-Port <Int32>]
[-UseSSL]
[-ThrottleLimit <Int32>]
[-State <SessionFilterState>]
[-SessionOption <PSSessionOption>]
[<CommonParameters>]
ConnectionUri
Get-PSSession
[-ConnectionUri] <Uri[]>
[-ConfigurationName <String>]
[-AllowRedirection]
[-Name <String[]>]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[-ThrottleLimit <Int32>]
[-State <SessionFilterState>]
[-SessionOption <PSSessionOption>]
[<CommonParameters>]
ConnectionUriInstanceId
Get-PSSession
[-ConnectionUri] <Uri[]>
-InstanceId <Guid[]>
[-ConfigurationName <String>]
[-AllowRedirection]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[-ThrottleLimit <Int32>]
[-State <SessionFilterState>]
[-SessionOption <PSSessionOption>]
[<CommonParameters>]
InstanceId
Get-PSSession
[-InstanceId <Guid[]>]
[<CommonParameters>]
Id
Get-PSSession
[-Id] <Int32[]>
[<CommonParameters>]
Description
A Get-PSSession parancsmag lekéri a felhasználó által felügyelt PowerShell-munkameneteket (PSSessions) helyi és távoli számítógépeken.
A Windows PowerShell 3.0-tól kezdve a munkamenetek az egyes kapcsolatok távoli végén található számítógépeken vannak tárolva. A Get-PSSessionComputerName vagy ConnectionUri paraméterével lekérheti a helyi számítógéphez vagy távoli számítógépekhez csatlakozó munkameneteket, még akkor is, ha azok nem az aktuális munkamenetben lettek létrehozva.
Paraméterek nélkül Get-PSSession az aktuális munkamenetben létrehozott összes munkamenetet lekéri.
Használja a szűrési paramétereket, beleértve
A többi paraméter használatával konfigurálhatja azt az ideiglenes kapcsolatot, amelyben a Get-PSSession parancs fut a ComputerName vagy ConnectionUri paraméterek használatakor.
MEGJEGYZÉS: A Windows PowerShell 2.0-ban paraméterek nélkül Get-PSSession az aktuális munkamenetben létrehozott összes munkamenetet lekéri. A ComputerName paraméter lekéri az aktuális munkamenetben létrehozott munkameneteket, és csatlakozik a megadott számítógéphez.
További információ a PowerShell-munkamenetekről: about_PSSessions.
Példák
1. példa: Az aktuális munkamenetben létrehozott munkamenetek lekérése
Get-PSSession
Ez a parancs lekéri az aktuális munkamenetben létrehozott összes PSSessions. Nem kap PSSessions, amelyeket más munkamenetekben vagy más számítógépeken hoztak létre, még akkor sem, ha ehhez a számítógéphez csatlakoznak.
2. példa: Munkamenetek csatlakoztatása a helyi számítógéphez
Get-PSSession -ComputerName "localhost"
Ez a parancs lekéri a helyi számítógéphez csatlakoztatott PSSessions. A helyi számítógép jelzéséhez írja be a számítógép nevét, a localhost vagy a pont (.)
A parancs a helyi számítógépen lévő összes munkamenetet visszaadja, még akkor is, ha különböző munkamenetekben vagy különböző számítógépeken lettek létrehozva.
3. példa: Munkamenetek csatlakoztatása számítógéphez
Get-PSSession -ComputerName "Server02"
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
2 Session3 Server02 Disconnected ITTasks Busy
1 ScheduledJobs Server02 Opened Microsoft.PowerShell Available
3 Test Server02 Disconnected Microsoft.PowerShell Busy
Ez a parancs lekéri a Server02 számítógéphez csatlakoztatott PSSessions.
A parancs a Server02 összes munkamenetét visszaadja, még akkor is, ha különböző munkamenetekben vagy különböző számítógépeken lettek létrehozva.
A kimenet azt mutatja, hogy két munkamenet leválasztott állapotú és foglalt rendelkezésre állású. Ezek különböző munkamenetekben lettek létrehozva, és jelenleg használatban vannak. A Megnyitott és elérhető Ütemezett feladatok munkamenet az aktuális munkamenetben lett létrehozva.
4. példa: A parancs eredményeinek mentése
New-PSSession -ComputerName Server01, Server02, Server03
$s1, $s2, $s3 = Get-PSSession
Ez a példa bemutatja, hogyan mentheti egy Get-PSSession parancs eredményeit több változóban.
Az első parancs a New-PSSession parancsmaggal hozza létre PSSessions három távoli számítógépen.
A második parancs egy Get-PSSession parancsmagot használ a három PSSessionslekéréséhez. Ezután a PSSessions egy külön változóba menti.
Amikor a PowerShell objektumtömböt rendel egy változótömbhöz, az első objektumot az első változóhoz, a második objektumot a második változóhoz stb. rendeli hozzá. Ha a változóknál több objektum van, az összes fennmaradó objektumot a tömb utolsó változójának rendeli hozzá. Ha az objektumoknál több változó van, a rendszer nem használja a további változókat.
5. példa: Munkamenet törlése példányazonosító használatával
Get-PSSession | Format-Table -Property ComputerName, InstanceID
$s = Get-PSSession -InstanceID a786be29-a6bb-40da-80fb-782c67f7db0f
Remove-PSSession -Session $s
Ez a példa bemutatja, hogyan kérhet le egy PSSession a példányazonosítójával, majd hogyan törölheti a PSSession.
Az első parancs lekéri az összes, az aktuális munkamenetben létrehozott PSSessions
A második parancs a Get-PSSession parancsmagot használja egy adott PSSession- lekéréséhez és a $s változóba való mentéséhez. A parancs a
A harmadik parancs a Remove-PSSession parancsmaggal törli a PSSession a $s változóban.
6. példa: Adott nevű munkamenet lekérése
A példában szereplő parancsok egy adott névformátumú munkamenetet találnak, amely egy adott munkamenet-konfigurációt használ, majd csatlakozik a munkamenethez. Az ehhez hasonló parancsokkal megkeresheti azt a munkamenetet, amelyben egy munkatárs elindított egy feladatot, és csatlakozhat a feladat befejezéséhez.
Get-PSSession -ComputerName Server02, Server12 -Name BackupJob* -ConfigurationName ITTasks -SessionOption @{OperationTimeout=240000}
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
3 BackupJob04 Server02 Disconnected ITTasks None
$s = Get-PSSession -ComputerName Server02 -Name BackupJob04 -ConfigurationName ITTasks | Connect-PSSession
$s
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
5 BackupJob04 Server02 Opened ITTasks Available
Az első parancs olyan munkameneteket kap a Server02 és a Server12 távoli számítógépeken, amelyek neve a BackupJob kezdetű, és az ITTasks-munkamenet konfigurációját használja. A parancs a Name paramétert használja a névminta és a ConfigurationName paraméter megadásához a munkamenet-konfiguráció megadásához. A SessionOption paraméter értéke egy kivonattábla, amely a OperationTimeout értékét 240000 ezredmásodpercre (4 perc) állítja. Ezzel a beállítással a parancs több időt vehet igénybe. A ConfigurationName és SessionOption paraméterekkel konfigurálhatók azok az ideiglenes munkamenetek, amelyekben a Get-PSSession parancsmag minden számítógépen fut. A kimenet azt mutatja, hogy a parancs a BackupJob04 munkamenetet adja vissza. A munkamenet megszakadt, és a rendelkezésre állási nincs, ami azt jelzi, hogy nincs használatban.
A második parancs a Get-PSSession parancsmaggal csatlakozik a BackupJob04 munkamenethez, a Connect-PSSession parancsmag pedig a munkamenethez való csatlakozáshoz. A parancs menti a munkamenetet a $s változóban.
A harmadik parancs lekéri a munkamenetet a $s változóban. A kimenet azt mutatja, hogy a Connect-PSSession parancs sikeres volt. A munkamenet Megnyitott állapotban van, és használható.
7. példa: Munkamenet lekérése az azonosítójával
Get-PSSession -Id 2
Ez a parancs lekéri a PSSession 2-s azonosítóval. Mivel a azonosító tulajdonság értéke csak az aktuális munkamenetben egyedi, a azonosító paraméter csak helyi parancsokra érvényes.
Paraméterek
-AllowRedirection
Azt jelzi, hogy ez a parancsmag lehetővé teszi a kapcsolat átirányítását egy alternatív egységes erőforrás-azonosítóra (URI). A PowerShell alapértelmezés szerint nem irányítja át a kapcsolatokat.
Ez a paraméter egy Get-PSSession parancs futtatásához létrehozott ideiglenes kapcsolatot konfigurálja a ConnectionUri paraméterrel.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
ConnectionUri
| 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 |
ConnectionUriInstanceId
| 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 |
-ApplicationName
Egy alkalmazás nevét adja meg. Ez a parancsmag csak a megadott alkalmazást használó munkamenetekhez csatlakozik.
Adja meg a kapcsolati URI alkalmazásnév-szegmensét.
Az alábbi kapcsolati URI-ban például az alkalmazás neve WSMan: https://localhost:5985/WSMAN.
A munkamenet alkalmazásnevét a rendszer a munkamenet Runspace.ConnectionInfo.AppName tulajdonságában tárolja.
Ennek a paraméternek az értéke a munkamenetek kiválasztására és szűrésére szolgál. A munkamenet által használt alkalmazást nem módosítja.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | All sessions |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
ComputerName
| 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 |
ComputerInstanceId
| 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 hitelesítő adatok hitelesítésére használt mechanizmust azon munkamenethez, amelyen a Get-PSSession parancs fut.
Ez a paraméter egy Get-PSSession parancs futtatásához létrehozott ideiglenes kapcsolatot konfigurálja a ComputerName vagy ConnectionUri paraméterrel.
A paraméter elfogadható értékei a következők:
- Alapértelmezett
- Alapszintű
- Credssp
- Összefoglaló
- Kerberos
- Tárgyal
- Tárgyalás implicit hitelesítő adatokkal.
Az alapértelmezett érték az Alapértelmezett.
A paraméter értékeivel kapcsolatos további információkért tekintse meg AuthenticationMechanism Enumeration az MSDN-kódtárban.
FIGYELEM: A hitelesítő adatok biztonsági támogatási 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.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
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
ComputerName
| 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 |
ComputerInstanceId
| 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 |
ConnectionUri
| 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 |
ConnectionUriInstanceId
| 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
Megadja egy olyan felhasználói fiók digitális nyilvános kulcsú tanúsítványát (X509), amely rendelkezik engedéllyel annak a munkamenetnek a létrehozásához, amelyben a Get-PSSession parancs fut. Adja meg a tanúsítvány ujjlenyomatát.
Ez a paraméter egy Get-PSSession parancs futtatásához létrehozott ideiglenes kapcsolatot konfigurálja a ComputerName vagy ConnectionUri paraméterrel.
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áljon egy Get-Item vagy Get-ChildItem parancsot a PowerShell Cert: meghajtón.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
ComputerName
| 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 |
ComputerInstanceId
| 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 |
ConnectionUri
| 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 |
ConnectionUriInstanceId
| 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
Megadja a számítógépek neveit tartalmazó tömböt. Lekéri a megadott számítógépekhez csatlakozó munkameneteket. A helyettesítő karakterek nem engedélyezettek. Nincs alapértelmezett érték.
A Windows PowerShell 3.0-tól kezdve PSSession objektumokat a rendszer az egyes kapcsolatok távoli végén lévő számítógépeken tárolja. A megadott számítógépek munkameneteinek lekéréséhez a PowerShell ideiglenes kapcsolatot hoz létre az egyes számítógépekhez, és futtat egy Get-PSSession parancsot.
Írja be egy vagy több 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 (.).
Megjegyzés: Ez a paraméter csak a PowerShell Windows PowerShell 3.0-s vagy újabb verzióit futtató számítógépekről szerzi be a munkameneteket. A korábbi verziók nem tárolják a munkameneteket.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Cn |
Paraméterkészletek
ComputerName
| Position: | 0 |
| Kötelező: | True |
| 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 |
ComputerInstanceId
| Position: | 0 |
| Kötelező: | True |
| 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 |
-ConfigurationName
Egy konfiguráció nevét adja meg. Ez a parancsmag csak a megadott munkamenet-konfigurációt használó munkamenetekre vonatkozik.
Adja meg a konfiguráció nevét vagy a munkamenet-konfiguráció teljes minősített erőforrás-URI-ját.
Ha csak a konfiguráció nevét adja meg, a következő séma URI-ja elő van állítva: https://schemas.microsoft.com/powershell.
A munkamenet konfigurációs neve a munkamenet ConfigurationName tulajdonságában van tárolva.
Ennek a paraméternek az értéke a munkamenetek kiválasztására és szűrésére szolgál. Nem módosítja a munkamenet által használt munkamenet-konfigurációt.
További információ a munkamenet-konfigurációkról: about_Session_Configurations.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | All sessions |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
ComputerName
| 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 |
ComputerInstanceId
| 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 |
ConnectionUri
| 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 |
ConnectionUriInstanceId
| 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 |
-ConnectionUri
Megadja az URI-t, amely meghatározza annak az ideiglenes munkamenetnek a kapcsolati végpontjait, amelyben a Get-PSSession parancs fut. Az URI-nak teljes mértékben minősítettnek kell lennie.
Ez a paraméter egy Get-PSSession parancs futtatásához létrehozott ideiglenes kapcsolatot konfigurálja a ConnectionUri paraméterrel.
A sztring formátuma a következő:
<Transport>://<ComputerName>:<Port>/<ApplicationName>
Az alapértelmezett érték a következő: https://localhost:5985/WSMAN.
Ha nem ad meg ConnectionUri, a UseSSL, ComputerName, Portés ApplicationName paramétereket használhatja a ConnectionURI értékek megadásához. 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 PowerShell-újraküldés alapértelmezett portjának használatához adja meg az 5985-ös portot a HTTP-hez, a HTTPS-hez pedig az 5986-os portot.
Ha a célszámítógép átirányítja a kapcsolatot egy másik URI-ra, a PowerShell megakadályozza az átirányítást, kivéve, ha a parancsban az AllowRedirection paramétert használja.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Ez a paraméter csak a Windows PowerShell 3.0-s vagy újabb verzióit futtató számítógépekről szerzi be a munkameneteket. A korábbi verziók nem tárolják a munkameneteket.
Paramétertulajdonságok
| Típus: | Uri[] |
| Alapértelmezett érték: | Http://localhost:5985/WSMAN |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | URI, CU |
Paraméterkészletek
ConnectionUri
| Position: | 0 |
| Kötelező: | True |
| 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 |
ConnectionUriInstanceId
| Position: | 0 |
| Kötelező: | True |
| 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 |
-Credential
Felhasználói hitelesítő adatokat ad meg.
Ez a parancsmag a megadott felhasználó engedélyeivel futtatja a parancsot.
Adjon meg egy felhasználói fiókot, amely jogosult csatlakozni a távoli számítógéphez, és futtasson egy Get-PSSession parancsot. Az alapértelmezett az aktuális felhasználó.
Írjon be egy felhasználónevet, például User01, Domain01\User01vagy 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.
Ez a paraméter egy Get-PSSession parancs futtatásához létrehozott ideiglenes kapcsolatra van konfigurálva a ComputerName vagy ConnectionUri paraméterrel.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | PSCredential |
| Alapértelmezett érték: | Current user |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
ComputerName
| 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 |
ComputerInstanceId
| 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 |
ConnectionUri
| 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 |
ConnectionUriInstanceId
| 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 |
-Id
A munkamenet-azonosítók tömbjének megadása. Ez a parancsmag csak a megadott azonosítókkal rendelkező munkameneteket kapja meg. Írjon be egy vagy több azonosítót vesszővel elválasztva, vagy használja a tartomány operátort (..) egy azonosítótartomány megadásához. Az azonosító paraméter nem használható együtt a ComputerName paraméterrel.
Az azonosító egy egész szám, amely egyedileg azonosítja a felhasználó által felügyelt munkameneteket az aktuális munkamenetben. Egyszerűbb megjegyezni és begépelni, mint a InstanceId, de csak az aktuális munkameneten belül egyedi. A munkamenet azonosítója a munkamenet azonosító tulajdonságában van tárolva.
Paramétertulajdonságok
| Típus: | Int32[] |
| Alapértelmezett érték: | All sessions |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
Id
| Position: | 0 |
| Kötelező: | True |
| 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 |
-InstanceId
A munkamenetek példányazonosítóinak tömbje. Ez a parancsmag csak a megadott példányazonosítókkal rendelkező munkameneteket kapja meg.
A példányazonosító egy GUID, amely egyedileg azonosít egy munkamenetet egy helyi vagy távoli számítógépen. A InstanceID akkor is egyedi, ha több munkamenet is fut a PowerShellben.
A munkamenet példányazonosítóját a rendszer a munkamenet InstanceID tulajdonságában tárolja.
Paramétertulajdonságok
| Típus: | Guid[] |
| Alapértelmezett érték: | All sessions |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
ComputerInstanceId
| Position: | Named |
| Kötelező: | True |
| 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 |
ConnectionUriInstanceId
| Position: | Named |
| Kötelező: | True |
| 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 |
InstanceId
| 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 munkamenetnevek tömbjének megadása. Ez a parancsmag csak azokat a munkameneteket kapja meg, amelyekhez a megadott rövid nevek tartoznak. A helyettesítő karakterek használata engedélyezett.
A munkamenet rövid neve a munkamenet Név tulajdonságában van tárolva.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | All sessions |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
Name
| 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 |
ComputerName
| 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 |
ConnectionUri
| 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 |
-Port
Megadja az ideiglenes kapcsolathoz használt megadott hálózati portot, amelyben a Get-PSSession parancs fut. 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 az 5985, amely a HTTP WinRM-portja, és az 5986, amely a HTTPS WinRM-portja.
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 írja be a következő két parancsot a PowerShell-parancssorba:
Remove-Item -Path WSMan:\Localhost\listener\listener* -Recurse
New-Item -Path WSMan:\Localhost\listener -Transport http -Address * -Port \<port-number\>
Ez a paraméter egy Get-PSSession parancs futtatásához létrehozott ideiglenes kapcsolatra van konfigurálva a ComputerName vagy ConnectionUri paraméterrel.
Ne használja a Port paramétert, hacsak nem szükséges. 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.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | Int32 |
| Alapértelmezett érték: | 5985, 5986 |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
ComputerName
| 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 |
ComputerInstanceId
| 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 a New-PSSessionOption parancsmaggal létrehozott objektumot, vagy egy kivonattáblát, amelyben a kulcsok munkamenet-beállításnevek, az értékek pedig munkamenet-beállításértékek.
A beállítások alapértelmezett értékeit az $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.
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.
További információ a munkamenet-konfigurációkról: about_Session_Configurations.
Paramétertulajdonságok
| Típus: | PSSessionOption |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
ComputerName
| 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 |
ComputerInstanceId
| 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 |
ConnectionUri
| 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 |
ConnectionUriInstanceId
| 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 |
-State
Munkamenet-állapotot ad meg. Ez a parancsmag csak a megadott állapotú munkameneteket kapja meg. A paraméter elfogadható értékei a következők: All, Opened, Disconnected, Closed és Broken. Az alapértelmezett érték az Összes.
A munkamenet-állapot értéke az aktuális munkamenetekhez viszonyítva van. Azok a munkamenetek, amelyek nem az aktuális munkamenetekben lettek létrehozva, és nem csatlakoznak az aktuális munkamenethez, akkor is megszakadt állapotban vannak, ha egy másik munkamenethez csatlakoznak.
A munkamenet állapota a munkamenet State tulajdonságában van tárolva.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | SessionFilterState |
| Alapértelmezett érték: | All |
| Elfogadott értékek: | All, Opened, Disconnected, Closed, Broken |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
ComputerName
| 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 |
ComputerInstanceId
| 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 |
ConnectionUri
| 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 |
ConnectionUriInstanceId
| 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 az egyidejű kapcsolatok maximális számát, amelyek a Get-PSSession parancs futtatásához hozhatók létre. Ha kihagyja ezt a paramétert, vagy 0 (nulla) értéket ad meg, a rendszer az alapértelmezett 32 értéket használja. A szabályozás korlátja csak az aktuális parancsra vonatkozik, a munkamenetre és a számítógépre nem.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | Int32 |
| Alapértelmezett érték: | 32 |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
ComputerName
| 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 |
ComputerInstanceId
| 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 |
ConnectionUri
| 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 |
ConnectionUriInstanceId
| 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 hozza létre azt a kapcsolatot, amelyben a Get-PSSession parancs fut. Alapértelmezés szerint az SSL nem használatos. Ha ezt a paramétert használja, de az SSL nem érhető el a parancshoz használt porton, a parancs meghiúsul.
Ez a paraméter úgy konfigurálja a létrehozott ideiglenes kapcsolatot, hogy egy Get-PSSession parancsot futtasson a ComputerName paraméterrel.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
ComputerName
| 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 |
ComputerInstanceId
| 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
None
Ehhez a parancsmaghoz nem csövezhet be bemenetet.
Kimenetek
PSSession
Jegyzetek
- Ez a parancsmag lekéri a felhasználó által felügyelt munkameneteket PSSession objektumokat, például a New-PSSession, Enter-PSSessionés Invoke-Command parancsmagok használatával létrehozottakat. Nem kapja meg a PowerShell indításakor létrehozott rendszer által felügyelt munkamenetet.
- A Windows PowerShell 3.0-tól kezdve PSSession objektumokat a kiszolgálóoldalon lévő vagy a kapcsolat végét fogadó számítógépen tárolja a rendszer. A helyi számítógépen vagy távoli számítógépen tárolt munkamenetek lekéréséhez a PowerShell létrehoz egy ideiglenes munkamenetet a megadott számítógépen, és lekérdezési parancsokat futtat a munkamenetben.
- Távoli számítógéphez csatlakozó munkamenetek lekéréséhez használja a ComputerName vagy ConnectionUri paramétereket a távoli számítógép megadásához. A Get-PSSession lekéréses
munkamenetek szűréséhez használja a Név ,azonosító ,InstanceID ésState paramétereket. A többi paraméter használatával konfigurálhatja a Get-PSSession által használt ideiglenes munkamenetet. - Ha a ComputerName vagy ConnectionUri paramétereket használja, a Get-PSSession csak a Windows PowerShell 3.0-s és újabb verzióit futtató számítógépekről kap munkameneteket.
- Egy PSSessionState tulajdonságának értéke az aktuális munkamenethez viszonyítva van. Ezért a leválasztott értéke azt jelenti, hogy a PSSession nincs csatlakoztatva az aktuális munkamenethez. Ez azonban nem jelenti azt, hogy a PSSession leválasztva van az összes munkamenetről. Lehet, hogy egy másik munkamenethez csatlakozik. Annak megállapításához, hogy az aktuális munkamenetből tud-e csatlakozni vagy újra csatlakozni a PSSession, használja a Rendelkezésre állási tulajdonságot.
A rendelkezésre állási értéke Nincs azt jelzi, hogy csatlakozhat a munkamenethez. A foglalt értéke azt jelzi, hogy nem tud csatlakozni a PSSession, mert egy másik munkamenethez van csatlakoztatva.
A munkamenetek State tulajdonságának értékeiről további információt RunspaceState Enumerationcímű témakörben talál.
A munkamenetek
Kapcsolódó hivatkozások
- Connect-PSSession (kapcsolódás PowerShell munkamenethez)
- Disconnect-PSSession
- Receive-PSSession
- Enter-PSSession (PowerShell parancs a távoli számítógéppel való interaktív munkamenet indítására)
- Exit-PSSession
- Parancs Meghívása
- New-PSSession
- Remove-PSSession parancs eltávolít egy PSSession-t
- PSSessions témakörről
- about_Távvezérlés