Get-PSSession
Lekéri a PowerShell-munkameneteket helyi és távoli számítógépeken.
Syntax
Get-PSSession
[-Name <String[]>]
[<CommonParameters>]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>]Get-PSSession
[-ComputerName] <String[]>
[-ApplicationName <String>]
[-ConfigurationName <String>]
-InstanceId <Guid[]>
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[-Port <Int32>]
[-UseSSL]
[-ThrottleLimit <Int32>]
[-State <SessionFilterState>]
[-SessionOption <PSSessionOption>]
[<CommonParameters>]Get-PSSession
[-ConnectionUri] <Uri[]>
[-ConfigurationName <String>]
[-AllowRedirection]
-InstanceId <Guid[]>
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[-ThrottleLimit <Int32>]
[-State <SessionFilterState>]
[-SessionOption <PSSessionOption>]
[<CommonParameters>]Get-PSSession
[-ConnectionUri] <Uri[]>
[-ConfigurationName <String>]
[-AllowRedirection]
[-Name <String[]>]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[-ThrottleLimit <Int32>]
[-State <SessionFilterState>]
[-SessionOption <PSSessionOption>]
[<CommonParameters>]Get-PSSession
[-ConfigurationName <String>]
[-Name <String[]>]
[-State <SessionFilterState>]
-ContainerId <String[]>
[<CommonParameters>]Get-PSSession
[-ConfigurationName <String>]
-InstanceId <Guid[]>
[-State <SessionFilterState>]
-ContainerId <String[]>
[<CommonParameters>]Get-PSSession
[-ConfigurationName <String>]
[-Name <String[]>]
[-State <SessionFilterState>]
-VMId <Guid[]>
[<CommonParameters>]Get-PSSession
[-ConfigurationName <String>]
-InstanceId <Guid[]>
[-State <SessionFilterState>]
-VMId <Guid[]>
[<CommonParameters>]Get-PSSession
[-ConfigurationName <String>]
[-Name <String[]>]
[-State <SessionFilterState>]
-VMName <String[]>
[<CommonParameters>]Get-PSSession
[-ConfigurationName <String>]
-InstanceId <Guid[]>
[-State <SessionFilterState>]
-VMName <String[]>
[<CommonParameters>]Get-PSSession
[-InstanceId <Guid[]>]
[<CommonParameters>]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 ComputerName vagy ConnectionUri paraméterekkel lekérheti a helyi számítógéphez vagy távoli számítógépekhez csatlakozó munkameneteketGet-PSSession, még akkor is, ha azok nem az aktuális munkamenetben lettek létrehozva.
Paraméterek Get-PSSession nélkül lekéri az aktuális munkamenetben létrehozott összes munkamenetet.
A visszaadott munkamenetek Get-PSSession közül a következő szűrési paraméterek közül választhat: Name, ID, InstanceID, State, ApplicationName és ConfigurationName.
A fennmaradó paraméterekkel konfigurálhatja azt az ideiglenes kapcsolatot, amelyben a Get-PSSession parancs fut a ComputerName vagy a ConnectionUri paraméterek használatakor.
Feljegyzés
A Windows PowerShell 2.0-ban paraméterek nélkül lekéri Get-PSSession az aktuális munkamenetben létrehozott összes munkamenetet. 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-PSSessionEz a parancs lekéri az aktuális munkamenetben létrehozott összes PSSessiont . Nem kap olyan PSSessionokat , 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 parancsokat . A helyi számítógép jelzéséhez írja be a számítógép nevét, localhost vagy 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 BusyEz a parancs lekéri a Server02 számítógéphez csatlakoztatott PSSessions parancsokat .
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 állapota és Busy rendelkezésre állása vanDisconnected.
Ezek különböző munkamenetekben lettek létrehozva, és jelenleg használatban vannak. A ScheduledJobs munkamenet, amely az Opened Availableaktuális munkamenetben lett létrehozva.
4. példa: A parancs eredményeinek mentése
New-PSSession -ComputerName Server01, Server02, Server03
$s1, $s2, $s3 = Get-PSSessionEz a példa bemutatja, hogyan mentheti egy Get-PSSession parancs eredményét több változóban.
Az első parancs a New-PSSession parancsmaggal hoz létre PSSessionst három távoli számítógépen.
A második parancs egy Get-PSSession parancsmagot használ a három PSSessions lekéréséhez. Ezután az összes PSSessiont 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 $sEz a példa bemutatja, hogyan szerezhet be PSSession-t a példányazonosítójával, majd hogyan törölheti a PSSessiont.
Az első parancs lekéri az aktuális munkamenetben létrehozott összes PSSessiont . Elküldi a PSSessions parancsmagot a Format-Table parancsmagnak, amely megjeleníti az egyes PSSession-ek ComputerName és InstanceID tulajdonságait.
A második parancs egy Get-PSSession adott PSSession lekéréséhez és a változóba mentéséhez használja a $s parancsmagot. A parancs az InstanceID paramétert használja a PSSession azonosításához.
A harmadik parancs a Remove-PSSession parancsmaggal törli a PSSessiont 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 AvailableAz első parancs lekéri azokat a munkameneteket a Server02 és a Server12 távoli számítógépeken, amelyeken a munkamenet-konfiguráció elején és használatában BackupJob ITTasks lévő nevek szerepelnek. A parancs a Név paraméter használatával adja meg a névmintát és a ConfigurationName paramétert a munkamenet-konfiguráció megadásához. A SessionOption paraméter értéke egy kivonattábla, amely az OperationTimeout 240000 értékét ezredmásodpercre (4 perc) állítja be. Ezzel a beállítással a parancs több időt vehet igénybe. A ConfigurationName és a 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 visszaadja a munkamenetet BackupJob04 . A munkamenet le van választva, és a rendelkezésre állás Noneazt jelzi, hogy nincs használatban.
A második parancs a parancsmagot használja a Get-PSSession BackupJob04 munkamenet eléréséhez, 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 2Ez a parancs lekéri a PSSession azonosítót2. Mivel az id tulajdonság értéke csak az aktuális munkamenetben egyedi, az 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 konfigurálja a létrehozott ideiglenes kapcsolatot, hogy a ConnectionUri paraméterrel futtatjon egy Get-PSSession parancsot.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
| Típus: | SwitchParameter |
| Position: | Named |
| Alapértelmezett érték: | False |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | 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: http://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.
| Típus: | String |
| Position: | Named |
| Alapértelmezett érték: | All sessions |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | False |
-Authentication
Megadja azt a mechanizmust, amely a parancs futtatásához használt munkamenet hitelesítő adatainak hitelesítésére Get-PSSession szolgál.
Ez a paraméter konfigurálja a létrehozott ideiglenes kapcsolatot, hogy a ComputerName vagy ConnectionUri paraméterrel futtatjon egy Get-PSSession parancsot.
A paraméter elfogadható értékei a következők:
DefaultBasicCredSSPDigestKerberosNegotiateNegotiateWithImplicitCredential.
Az alapértelmezett érték Default.
A paraméter értékeivel kapcsolatos további információkért lásd : AuthenticationMechanism Enumeration.
Figyelemfelhívás
A hitelesítő adatok biztonsági támogatási szolgáltatójának (CredSSP) hitelesítése, amelyben a felhasználó hitelesítő adatai á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.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
| Típus: | AuthenticationMechanism |
| Elfogadott értékek: | Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos |
| Position: | Named |
| Alapértelmezett érték: | Default |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | 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 ahhoz a munkamenethez, amelyben a Get-PSSession parancs fut. Adja meg a tanúsítvány ujjlenyomatát.
Ez a paraméter konfigurálja a létrehozott ideiglenes kapcsolatot, hogy a ComputerName vagy ConnectionUri paraméterrel futtatjon egy Get-PSSession parancsot.
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 vagy Get-ChildItem több Get-Item parancsot a PowerShell-meghajtónCert:.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
| Típus: | String |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-ComputerName
A számítógépek nevének tömbje. 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 a 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 létrehoz egy ideiglenes kapcsolatot 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 vagy localhostpontját (.).
Feljegyzés
Ez a paraméter csak a PowerShell Windows PowerShell 3.0-s vagy újabb verzióit futtató számítógépekről kap munkameneteket. A korábbi verziók nem tárolják a munkameneteket.
| Típus: | String[] |
| Aliasok: | Cn |
| Position: | 0 |
| Alapértelmezett érték: | None |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | 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 erőforrás-URI-címét. Ha csak a konfiguráció nevét adja meg, a rendszer a következő séma URI-ját előpendálta: http://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.
A munkamenet-konfigurációkkal kapcsolatos további tudnivalókért tekintse meg az about_Session_Configuration_Files című témakört.
| Típus: | String |
| Position: | Named |
| Alapértelmezett érték: | All sessions |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | False |
-ConnectionUri
Egy URI-t ad meg, 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 konfigurálja a létrehozott ideiglenes kapcsolatot, hogy a ConnectionUri paraméterrel futtatjon egy Get-PSSession parancsot.
A sztring formátuma a következő:
<Transport>://<ComputerName>:<Port\>/<ApplicationName>
Az alapértelmezett érték a következő: http://localhost:5985/WSMAN.
Ha nem ad meg ConnectionUri értéket, a ConnectionURI-értékek megadásához használhatja a UseSSL, a ComputerName, a Port és az ApplicationName paramétereket. 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 PowerShell-újraküldés alapértelmezett portjának használatához adja meg a HTTP-portot 5985 vagy 5986 a HTTPS-t.
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, hacsak nem használja az AllowRedirection paramétert a parancsban.
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.
| Típus: | Uri[] |
| Aliasok: | URI, CU |
| Position: | 0 |
| Alapértelmezett érték: | Http://localhost:5985/WSMAN |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | False |
-ContainerId
Tárolók azonosítóinak tömbje. Ez a parancsmag egy interaktív munkamenetet indít el a megadott tárolókkal. docker ps A parancs használatával lekérheti a tárolóazonosítók listáját. További információt a docker ps parancs súgójában talál.
| Típus: | String[] |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | 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 rendelkezik engedéllyel a távoli számítógéphez való csatlakozáshoz és egy Get-PSSession parancs futtatásához. Alapértelmezés szerint az aktuális felhasználó.
Írjon be egy felhasználónevet, például User01 vagy Domain01\User01adjon meg egy, a Get-Credential parancsmag által létrehozott PSCredential objektumot. Ha beír egy felhasználónevet, a rendszer kéri a jelszó megadását.
A hitelesítő adatokat PSCredential objektum tárolja, a jelszót pedig SecureStringként tárolja a rendszer.
Feljegyzés
További információ a SecureString adatvédelemről: Mennyire biztonságos a SecureString?.
Ez a paraméter arra az ideiglenes kapcsolatra van konfigurálva, amely úgy jön létre, hogy egy Get-PSSession parancsot futtasson a ComputerName vagy a ConnectionUri paraméterrel.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
| Típus: | PSCredential |
| Position: | Named |
| Alapértelmezett érték: | Current user |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | 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 id paramétert nem használhatja 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 az 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.
| Típus: | Int32[] |
| Position: | 0 |
| Alapértelmezett érték: | All sessions |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | 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. Az InstanceID egyedi, még akkor is, ha több munkamenet fut a PowerShellben.
A munkamenet példányazonosítója a munkamenet InstanceID tulajdonságában van tárolva.
| Típus: | Guid[] |
| Position: | Named |
| Alapértelmezett érték: | All sessions |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | 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.
| Típus: | String[] |
| Position: | Named |
| Alapértelmezett érték: | All sessions |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | True |
-Port
Megadja a parancs futtatásához használt ideiglenes kapcsolathoz Get-PSSession használt megadott hálózati portot. 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 5985a HTTP WinRM-portja, és 5986a 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 arra az ideiglenes kapcsolatra van konfigurálva, amely úgy jön létre, hogy egy Get-PSSession parancsot futtasson a ComputerName vagy a ConnectionUri paraméterrel.
Csak akkor használja a Port 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.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
| Típus: | Int32 |
| Position: | Named |
| Alapértelmezett érték: | 5985, 5986 |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-SessionOption
A munkamenet speciális beállításait adja meg. Adjon meg egy SessionOption objektumot, például a parancsmaggal New-PSSessionOption 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 a beállítási változó értéke $PSSessionOption 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 beállításváltozóban és a $PSSessionOption 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 következőt New-PSSessionOption: .
A beállítási változóval kapcsolatos információkért $PSSessionOption lásd : about_Preference_Variables. A munkamenet-konfigurációkkal kapcsolatos további tudnivalókért tekintse meg az about_Session_Configuration_Files című témakört.
| Típus: | PSSessionOption |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | 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 All.
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 állapotban vannak Disconnected , ha egy másik munkamenethez csatlakoznak.
A munkamenet állapota a munkamenet Állapot tulajdonságában van tárolva.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
| Típus: | SessionFilterState |
| Elfogadott értékek: | All, Opened, Disconnected, Closed, Broken |
| Position: | Named |
| Alapértelmezett érték: | All |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-ThrottleLimit
Megadja a parancs futtatásához Get-PSSession létrehozható egyidejű kapcsolatok maximális számát. Ha kihagyja ezt a paramétert, vagy egy (nulla) értéket 0 ad meg, 32akkor a rendszer az alapértelmezett é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.
| Típus: | Int32 |
| Position: | Named |
| Alapértelmezett érték: | 32 |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-UseSSL
Azt jelzi, hogy ez a parancsmag a Secure Sockets Layer (SSL) protokollt használja annak a kapcsolatnak a létrehozásához, 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 konfigurálja a létrehozott ideiglenes kapcsolatot, hogy a ComputerName paraméterrel futtatjon egy Get-PSSession parancsot.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
| Típus: | SwitchParameter |
| Position: | Named |
| Alapértelmezett érték: | False |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-VMId
A virtuális gépek azonosítójának tömbje. Ez a parancsmag egy interaktív munkamenetet indít el a megadott virtuális gépek mindegyikével. Az Ön számára elérhető virtuális gépek megtekintéséhez használja a következő parancsot:
Get-VM | Select-Object -Property Name, ID
| Típus: | Guid[] |
| Aliasok: | VMGuid |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | False |
-VMName
A virtuális gépek nevének tömbje. Ez a parancsmag egy interaktív munkamenetet indít el a megadott virtuális gépek mindegyikével. A rendelkezésére álló virtuális gépek megtekintéséhez használja a Get-VM parancsmagot.
| Típus: | String[] |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | False |
Bevitelek
None
Ehhez a parancsmaghoz nem lehet objektumokat csövezni.
Kimenetek
Jegyzetek
A Windows PowerShell a következő aliasokat Get-PSSessiontartalmazza:
gsnEz a parancsmag lekéri a felhasználó által felügyelt munkamenetek PSSession objektumait, például azokat, amelyek a ,
Enter-PSSessionésInvoke-CommandparancsmagokNew-PSSessionhasználatával jönnek létre. Nem kapja meg a PowerShell indításakor létrehozott rendszer által felügyelt munkamenetet.A Windows PowerShell 3.0-tól kezdve a PSSession-objektumok a kiszolgálóoldalon lévő vagy a kapcsolat végét fogadó számítógépen vannak tárolva. 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 lekérendő
Get-PSSessionmunkamenetek szűréséhez használja a Név, az Azonosító, a Példányazonosító és az Állapot paramétereket. A többi paraméter használatával konfigurálja a használt ideiglenes munkamenetetGet-PSSession.A ComputerName vagy ConnectionUri paraméterek
Get-PSSessionhasználatakor csak a PowerShell Windows PowerShell 3.0-s és újabb verzióit futtató számítógépekről kap munkameneteket.A PSSession State tulajdonságának értéke az aktuális munkamenethez viszonyítva van. Ezért a leválasztott érték 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 PSSessionhoz , használja a Rendelkezésre állás tulajdonságot .
A Nincs rendelkezésre állás értéke azt jelzi, hogy csatlakozhat a munkamenethez. A Foglalt érték azt jelzi, hogy nem tud csatlakozni a PSSessionhoz, mert egy másik munkamenethez van csatlakoztatva.
A munkamenetek State tulajdonságának értékeiről további információt a RunspaceState Enumerálás című témakörben talál.
A munkamenetek Rendelkezésre állási tulajdonságának értékeiről további információt a RunspaceAvailability Enumeration című témakörben talál.
