Get-PSSession
Lekéri a 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>]
VMNameInstanceId
Get-PSSession
-InstanceId <Guid[]>
-VMName <String[]>
[-ConfigurationName <String>]
[-State <SessionFilterState>]
[<CommonParameters>]
ContainerId
Get-PSSession
-ContainerId <String[]>
[-ConfigurationName <String>]
[-Name <String[]>]
[-State <SessionFilterState>]
[<CommonParameters>]
ContainerIdInstanceId
Get-PSSession
-InstanceId <Guid[]>
-ContainerId <String[]>
[-ConfigurationName <String>]
[-State <SessionFilterState>]
[<CommonParameters>]
VMId
Get-PSSession
-VMId <Guid[]>
[-ConfigurationName <String>]
[-Name <String[]>]
[-State <SessionFilterState>]
[<CommonParameters>]
VMIdInstanceId
Get-PSSession
-InstanceId <Guid[]>
-VMId <Guid[]>
[-ConfigurationName <String>]
[-State <SessionFilterState>]
[<CommonParameters>]
VMName
Get-PSSession
-VMName <String[]>
[-ConfigurationName <String>]
[-Name <String[]>]
[-State <SessionFilterState>]
[<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 ComputerName vagy Get-PSSession 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 Name, ID, InstanceID, State, ApplicationNameés ConfigurationName a visszaadott Get-PSSession munkamenetek közül való választáshoz.
A többi paraméter használatával konfigurálhatja azt az ideiglenes kapcsolatot, amelyben a Get-PSSession parancs a ComputerName vagy ConnectionUri paraméter használatakor fut.
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, 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 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 Disconnected állapotú és Busy rendelkezésre állással rendelkezik.
Ezek különböző munkamenetekben lettek létrehozva, és jelenleg használatban vannak. A ScheduledJobs és OpenedAvailable 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ényét több változóban.
Az első parancs a New-PSSession parancsmaggal hoz 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 Format-Table parancsmagnak, amely megjeleníti az egyes PSSessionComputerName és InstanceID tulajdonságait.
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 BackupJob kezdődik, és a ITTasks munkamenet-konfiguráció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 be. Ezzel a beállítással a parancs több időt vehet igénybe. A ConfigurationName és SessionOption paraméterekkel konfigurálja azokat az ideiglenes munkameneteket, 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ásiNone, ami azt jelzi, hogy nincs használatban.
A második parancs a Get-PSSession parancsmaggal jut el 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 azonosítóval 2. 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 úgy konfigurálja a létrehozott ideiglenes kapcsolatot, hogy egy Get-PSSession parancsot futtasson 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
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 |
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 |
-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.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | All sessions |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
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 |
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 |
-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 konfigurálja a létrehozott ideiglenes kapcsolatot egy Get-PSSession parancs futtatásához a ComputerName vagy ConnectionUri paraméterrel.
A paraméter elfogadható értékei a következők:
DefaultBasicCredSSPDigestKerberosNegotiate-
NegotiateWithImplicitCredential.
Az alapértelmezett érték a Default.
A paraméter értékeivel kapcsolatos további információkért lásd AuthenticationMechanism Enumeration.
Figyelmezteté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.
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
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 |
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 |
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 |
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 |
-CertificateThumbprint
Egy olyan felhasználói fiók digitális nyilvános kulcsú tanúsítványát (X509) adja meg, amely jogosult létrehozni azt a munkamenetet, 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 egy Get-PSSession parancs futtatásához 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
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 |
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 |
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 |
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 |
-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. Ha a megadott számítógépeken szeretné lekérni a munkameneteket, 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, localhostvagy 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 kap 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
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 |
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 |
-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: 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.
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
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 |
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 |
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
| 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 |
ContainerId
| 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 |
ContainerIdInstanceId
| 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 |
VMId
| 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 |
VMIdInstanceId
| 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 |
VMName
| 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 |
VMNameInstanceId
| 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 a kapcsolati végpontot ahhoz az ideiglenes munkamenethez, amelyben a Get-PSSession parancs fut. Az URI-nak teljes mértékben minősítettnek kell lennie.
Ez a paraméter úgy konfigurálja a létrehozott ideiglenes kapcsolatot, hogy egy Get-PSSession parancsot futtasson a ConnectionUri paraméterrel.
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, 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 és HTTPS-443. A PowerShell-újraküldés alapértelmezett portjának használatához adja meg a HTTP-hez 5985 vagy a HTTPS-5986 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
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 |
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 |
-ContainerId
Tárolók azonosítóinak tömbje. Ez a parancsmag egy interaktív munkamenetet indít el a megadott tárolókkal. A tárolóazonosítók listájának lekéréséhez használja a docker ps parancsot. További információt a docker ps parancs súgójában talál.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
ContainerId
| Position: | Named |
| 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 |
ContainerIdInstanceId
| Position: | Named |
| 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 rendelkezik engedéllyel a távoli számítógéphez való csatlakozáshoz, és futtasson egy Get-PSSession parancsot. Az alapértelmezett az aktuális felhasználó.
Írjon be egy felhasználónevet, például User01 vagy Domain01\User01, vagy adjon meg egy PSCredential objektumot, amelyet a Get-Credential parancsmag hoz létre. Ha beír egy felhasználónevet, a rendszer kéri a jelszó megadását.
A hitelesítő adatokat egy PSCredential objektum tárolja, a jelszó pedig SecureString.
Megjegyzés:
További információért a SecureString adatvédelemről lásd: 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 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
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 |
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 |
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 |
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 |
-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ányoperátort (..) az azonosítók tartományának 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ójának 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 |
ContainerIdInstanceId
| 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 |
VMIdInstanceId
| 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 |
VMNameInstanceId
| 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 |
ContainerId
| 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 |
VMId
| 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 |
VMName
| 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 a megadott hálózati portot, amely a Get-PSSession parancs futtatásához használt ideiglenes kapcsolathoz használatos. 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 5985, amely a HTTP WinRM-portja, és 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 arra az ideiglenes kapcsolatra van konfigurálva, amely úgy jön létre, hogy egy Get-PSSession parancsot futtasson 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
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 |
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 |
-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 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.
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
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 |
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 |
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 |
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 |
-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 a All.
A munkamenet-állapot értéke az aktuális munkamenetekhez viszonyítva van. Az aktuális munkamenetekben nem létrehozott és az aktuális munkamenethez nem kapcsolódó munkamenetek akkor is Disconnected á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
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 |
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 |
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 |
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 |
ContainerId
| 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 |
ContainerIdInstanceId
| 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 |
VMId
| 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 |
VMIdInstanceId
| 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 |
VMName
| 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 |
VMNameInstanceId
| 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
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 |
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 |
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 |
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 |
-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 egy Get-PSSession parancs futtatásához 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
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 |
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 |
-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
Paramétertulajdonságok
| Típus: | Guid[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | VMGuid |
Paraméterkészletek
VMId
| Position: | Named |
| 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 |
VMIdInstanceId
| Position: | Named |
| 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 |
-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. Az Ön számára elérhető virtuális gépek megtekintéséhez használja a Get-VM parancsmagot.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
VMName
| Position: | Named |
| 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 |
VMNameInstanceId
| Position: | Named |
| 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 |
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 lehet objektumokat csövezni.
Kimenetek
PSSession
Jegyzetek
A PowerShell a következő aliasokat tartalmazza Get-PSSession:
Minden platform:
gsn
Ez a parancsmag lekéri a felhasználó által felügyelt munkameneteket PSSession objektumokat, például azokat, amelyeket a
New-PSSession,Enter-PSSessionésInvoke-Commandparancsmagok használatával hoztak 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 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-PSSessionlekért munkamenetek szűréséhez használja a Név, azonosító, InstanceIDés State paramétereket. A fennmaradó paraméterekkel konfigurálhatja aGet-PSSessionáltal használt ideiglenes munkamenetet.Ha a ComputerName vagy ConnectionUri paramétereket használja,
Get-PSSessioncsak a Windows PowerShell 3.0-s és újabb PowerShell-verziót 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