Delen via


Get-PSSession

Hiermee haalt u de PowerShell-sessies op lokale en externe computers op.

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]
   [-Name <String[]>]
   [-Credential <PSCredential>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <String>]
   [-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
   [-ConfigurationName <String>]
   -InstanceId <Guid[]>
   [-State <SessionFilterState>]
   -VMName <String[]>
   [<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
   [-InstanceId <Guid[]>]
   [<CommonParameters>]
Get-PSSession
   [-Id] <Int32[]>
   [<CommonParameters>]

Description

De Get-PSSession cmdlet haalt de door de gebruiker beheerde PowerShell-sessies (PSSessions) op lokale en externe computers op.

Vanaf Windows PowerShell 3.0 worden sessies opgeslagen op de computers aan het externe einde van elke verbinding. U kunt de parameters ComputerName of ConnectionUri van Get-PSSession gebruiken om de sessies op te halen die verbinding maken met de lokale computer of externe computers, zelfs als ze niet in de huidige sessie zijn gemaakt.

Zonder parameters haalt Get-PSSession u alle sessies op die in de huidige sessie zijn gemaakt.

Gebruik de filterparameters, waaronder Name, ID, InstanceID, State, ApplicationName en ConfigurationName om een keuze te maken uit de sessies die Get-PSSession worden geretourneerd.

Gebruik de resterende parameters om de tijdelijke verbinding te configureren waarin de Get-PSSession opdracht wordt uitgevoerd wanneer u de parameters ComputerName of ConnectionUri gebruikt.

Notitie

In Windows PowerShell 2.0 worden zonder parameters Get-PSSession alle sessies opgevraagd die in de huidige sessie zijn gemaakt. De parameter ComputerName haalt sessies op die zijn gemaakt in de huidige sessie en maakt verbinding met de opgegeven computer.

Zie about_PSSessions voor meer informatie over PowerShell-sessies.

Voorbeelden

Voorbeeld 1: Sessies ophalen die in de huidige sessie zijn gemaakt

Get-PSSession

Met deze opdracht worden alle PSSessions opgeslagen die in de huidige sessie zijn gemaakt. Het krijgt geen PSSessions die zijn gemaakt in andere sessies of op andere computers, zelfs niet als ze verbinding maken met deze computer.

Voorbeeld 2: Sessies verbinden met de lokale computer

Get-PSSession -ComputerName "localhost"

Met deze opdracht haalt u de PSSessions op die zijn verbonden met de lokale computer. Als u de lokale computer wilt aangeven, typt u de computernaam, localhost of een punt (.)

De opdracht retourneert alle sessies op de lokale computer, zelfs als ze zijn gemaakt in verschillende sessies of op verschillende computers.

Voorbeeld 3: Sessies verbinden met een computer

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

Met deze opdracht haalt u de PSSessions op die zijn verbonden met de Server02-computer.

De opdracht retourneert alle sessies op Server02, zelfs als ze zijn gemaakt in verschillende sessies of op verschillende computers.

In de uitvoer ziet u dat twee van de sessies een Disconnected status en een Busy beschikbaarheid hebben. Ze zijn gemaakt in verschillende sessies en worden momenteel gebruikt. De ScheduledJobs sessie, namelijk en Available, is Opened gemaakt in de huidige sessie.

Voorbeeld 4: De resultaten van deze opdracht opslaan

New-PSSession -ComputerName Server01, Server02, Server03
$s1, $s2, $s3 = Get-PSSession

In dit voorbeeld ziet u hoe u de resultaten van een Get-PSSession opdracht in meerdere variabelen opslaat.

De eerste opdracht gebruikt de New-PSSession cmdlet om PSSessions te maken op drie externe computers.

De tweede opdracht maakt gebruik van een Get-PSSession cmdlet om de drie PSSessions op te halen. Vervolgens worden alle PSSessions in een afzonderlijke variabele opgeslagen.

Wanneer PowerShell een matrix met objecten toewijst aan een matrix van variabelen, wordt het eerste object toegewezen aan de eerste variabele, het tweede object aan de tweede variabele, enzovoort. Als er meer objecten dan variabelen zijn, worden alle resterende objecten toegewezen aan de laatste variabele in de matrix. Als er meer variabelen dan objecten zijn, worden de extra variabelen niet gebruikt.

Voorbeeld 5: Een sessie verwijderen met behulp van een exemplaar-id

Get-PSSession | Format-Table -Property ComputerName, InstanceID
$s = Get-PSSession -InstanceID a786be29-a6bb-40da-80fb-782c67f7db0f
Remove-PSSession -Session $s

In dit voorbeeld ziet u hoe u een PSSession kunt ophalen met behulp van de instantie-id en vervolgens de PSSession verwijdert.

Met de eerste opdracht worden alle PSSessions opgeslagen die in de huidige sessie zijn gemaakt. De PSSessions worden verzonden naar de Format-Table cmdlet, waarin de eigenschappen ComputerName en InstanceID van elke PSSession worden weergegeven.

De tweede opdracht gebruikt de Get-PSSession cmdlet om een bepaalde PSSession op te halen en op te slaan in de $s variabele. De opdracht gebruikt de parameter InstanceID om de PSSession te identificeren.

De derde opdracht gebruikt de cmdlet Remove-PSSession om de PSSession in de $s variabele te verwijderen.

Voorbeeld 6: Een sessie ophalen met een bepaalde naam

Met de opdrachten in dit voorbeeld wordt een sessie gezocht die een bepaalde naamindeling heeft en een bepaalde sessieconfiguratie gebruikt en vervolgens verbinding maakt met de sessie. U kunt een opdracht zoals deze gebruiken om een sessie te vinden waarin een collega een taak heeft gestart en verbinding te maken om de taak te voltooien.

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

Met de eerste opdracht worden sessies op de externe computers Server02 en Server12 met namen die beginnen met BackupJob en de ITTasks sessieconfiguratie gebruiken. De opdracht gebruikt de parameter Name om het naampatroon en de parameter ConfigurationName op te geven om de sessieconfiguratie op te geven. De waarde van de parameter SessionOption is een hashtabel waarmee de waarde van de OperationTimeout wordt ingesteld op 240000 milliseconden (4 minuten). Deze instelling geeft de opdracht meer tijd om te voltooien. De parameters ConfigurationName en SessionOption worden gebruikt om de tijdelijke sessies te configureren waarin de Get-PSSession cmdlet op elke computer wordt uitgevoerd. De uitvoer laat zien dat de opdracht de sessie retourneert BackupJob04 . De sessie is verbroken en de beschikbaarheid is None, wat aangeeft dat deze niet in gebruik is.

De tweede opdracht gebruikt de Get-PSSession cmdlet om naar de BackupJob04 sessie te gaan en de Connect-PSSession cmdlet om verbinding te maken met de sessie. Met de opdracht wordt de sessie opgeslagen in de $s variabele.

Met de derde opdracht wordt de sessie in de $s variabele opgeslagen. De uitvoer laat zien dat de Connect-PSSession opdracht is geslaagd. De sessie heeft de status Geopend en is beschikbaar voor gebruik.

Voorbeeld 7: Een sessie ophalen met behulp van de bijbehorende id

Get-PSSession -Id 2

Met deze opdracht wordt de PSSession met id 2opgehaald. Omdat de waarde van de id-eigenschap alleen uniek is in de huidige sessie, is de parameter Id alleen geldig voor lokale opdrachten.

Parameters

-AllowRedirection

Geeft aan dat deze cmdlet omleiding van deze verbinding naar een alternatieve URI (Uniform Resource Identifier) toestaat. Standaard worden verbindingen niet door PowerShell omgeleid.

Met deze parameter configureert u de tijdelijke verbinding die wordt gemaakt om een Get-PSSession opdracht uit te voeren met de parameter ConnectionUri .

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ApplicationName

Hiermee geeft u de naam van een toepassing. Deze cmdlet maakt alleen verbinding met sessies die gebruikmaken van de opgegeven toepassing.

Voer het toepassingsnaamsegment van de verbindings-URI in. In de volgende verbindings-URI is de naam van de toepassing bijvoorbeeld WSMan: http://localhost:5985/WSMAN. De toepassingsnaam van een sessie wordt opgeslagen in de eigenschap Runspace.ConnectionInfo.AppName van de sessie.

De waarde van deze parameter wordt gebruikt voor het selecteren en filteren van sessies. De toepassing die door de sessie wordt gebruikt, wordt niet gewijzigd.

Type:String
Position:Named
Default value:All sessions
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Authentication

Hiermee geeft u het mechanisme op dat wordt gebruikt om referenties te verifiëren voor de sessie waarin de Get-PSSession opdracht wordt uitgevoerd.

Met deze parameter configureert u de tijdelijke verbinding die wordt gemaakt om een Get-PSSession opdracht uit te voeren met de parameter ComputerName of ConnectionUri .

De aanvaardbare waarden voor deze parameter zijn:

  • Default
  • Basic
  • CredSSP
  • Digest
  • Kerberos
  • Negotiate
  • NegotiateWithImplicitCredential.

De standaardwaarde is Default.

Zie AuthenticationMechanism Enumeration voor meer informatie over de waarden van deze parameter.

Waarschuwing

CredSSP-verificatie (Credential Security Support Provider), waarbij de referenties van de gebruiker worden doorgegeven aan een externe computer om te worden geverifieerd, is ontworpen voor opdrachten waarvoor verificatie op meer dan één resource is vereist, zoals toegang tot een externe netwerkshare. Dit mechanisme verhoogt het beveiligingsrisico van de externe bewerking. Als de externe computer is gecompromitteerd, kunnen de referenties die aan de computer worden doorgegeven, worden gebruikt om de netwerksessie te beheren.

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Type:AuthenticationMechanism
Accepted values:Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos
Position:Named
Default value:Default
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CertificateThumbprint

Hiermee geeft u het digitale openbare sleutelcertificaat (X509) van een gebruikersaccount met machtigingen voor het maken van de sessie waarin de Get-PSSession opdracht wordt uitgevoerd. Voer de vingerafdruk van het certificaat in.

Met deze parameter configureert u de tijdelijke verbinding die wordt gemaakt om een Get-PSSession opdracht uit te voeren met de parameter ComputerName of ConnectionUri .

Certificaten worden gebruikt in verificatie op basis van clientcertificaten. Ze kunnen alleen worden toegewezen aan lokale gebruikersaccounts; ze werken niet met domeinaccounts.

Als u een vingerafdruk van een certificaat wilt ophalen, gebruikt u de Get-Item opdracht of Get-ChildItem in het PowerShell-station Cert: .

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ComputerName

Hiermee geeft u een matrix met namen van computers. Haalt de sessies op die verbinding maken met de opgegeven computers. Jokertekens zijn niet toegestaan. Er is geen standaardwaarde.

Vanaf Windows PowerShell 3.0 worden PSSession-objecten opgeslagen op de computers aan het externe uiteinde van elke verbinding. PowerShell maakt een tijdelijke verbinding met elke computer en voert een Get-PSSession opdracht uit om de sessies op de opgegeven computers op te halen.

Typ de NetBIOS-naam, een IP-adres of een volledig gekwalificeerde domeinnaam van een of meer computers. Als u de lokale computer wilt opgeven, typt u de computernaam , localhostof een punt (.).

Notitie

Met deze parameter worden sessies alleen opgehaald van computers met Windows PowerShell 3.0 of latere versies van PowerShell. In eerdere versies worden geen sessies opgeslagen.

Type:String[]
Aliases:Cn
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ConfigurationName

Hiermee geeft u de naam van een configuratie. Deze cmdlet krijgt alleen toegang tot sessies die gebruikmaken van de opgegeven sessieconfiguratie.

Voer een configuratienaam of de volledig gekwalificeerde resource-URI in voor een sessieconfiguratie. Als u alleen de configuratienaam opgeeft, wordt de volgende schema-URI vooraf gebruikt: http://schemas.microsoft.com/powershell. De configuratienaam van een sessie wordt opgeslagen in de eigenschap ConfigurationName van de sessie.

De waarde van deze parameter wordt gebruikt voor het selecteren en filteren van sessies. De sessieconfiguratie die door de sessie wordt gebruikt, wordt niet gewijzigd.

Zie about_Session_Configurations (Engelstalig) voor meer informatie over sessieconfiguraties.

Type:String
Position:Named
Default value:All sessions
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ConnectionUri

Hiermee geeft u een URI die het verbindingseindpunt definieert voor de tijdelijke sessie waarin de Get-PSSession opdracht wordt uitgevoerd. De URI moet volledig zijn gekwalificeerd.

Met deze parameter configureert u de tijdelijke verbinding die wordt gemaakt om een Get-PSSession opdracht uit te voeren met de parameter ConnectionUri .

De indeling van deze tekenreeks is:

<Transport>://<ComputerName>:<Port\>/<ApplicationName>

De standaardwaarde is: http://localhost:5985/WSMAN.

Als u geen ConnectionUri opgeeft, kunt u de parameters UseSSL, ComputerName, Port en ApplicationName gebruiken om de ConnectionURI-waarden op te geven. Geldige waarden voor het transportsegment van de URI zijn HTTP en HTTPS. Als u een verbindings-URI met een transportsegment opgeeft, maar geen poort opgeeft, wordt de sessie gemaakt met standaardpoorten: 80 voor HTTP en 443 voor HTTPS. Als u de standaardpoorten voor externe communicatie met PowerShell wilt gebruiken, geeft u de poort 5985 op voor HTTP of 5986 voor HTTPS.

Als de doelcomputer de verbinding omleidt naar een andere URI, voorkomt PowerShell de omleiding, tenzij u de parameter AllowRedirection in de opdracht gebruikt.

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Met deze parameter worden sessies alleen opgehaald van computers met Windows PowerShell 3.0 of latere versies van Windows PowerShell. In eerdere versies worden geen sessies opgeslagen.

Type:Uri[]
Aliases:URI, CU
Position:0
Default value:Http://localhost:5985/WSMAN
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ContainerId

Hiermee geeft u een matrix van id's van containers op. Deze cmdlet start een interactieve sessie met elk van de opgegeven containers. Gebruik de docker ps opdracht om een lijst met container-id's op te halen. Zie de help voor de opdracht docker ps voor meer informatie.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Credential

Hiermee geeft u een gebruikersreferentie op. Met deze cmdlet wordt de opdracht uitgevoerd met de machtigingen van de opgegeven gebruiker. Geef een gebruikersaccount op dat is gemachtigd om verbinding te maken met de externe computer en een Get-PSSession opdracht uit te voeren. Standaard is dit de huidige gebruiker.

Typ een gebruikersnaam, zoals User01 of Domain01\User01, of voer een PSCredential-object in dat door de Get-Credential cmdlet is gegenereerd. Als u een gebruikersnaam typt, wordt u gevraagd het wachtwoord in te voeren.

Referenties worden opgeslagen in een PSCredential-object en het wachtwoord wordt opgeslagen als een SecureString.

Notitie

Zie Hoe veilig is SecureString? voor meer informatie over SecureString-gegevensbeveiliging.

Met deze parameter wordt geconfigureerd voor de tijdelijke verbinding die wordt gemaakt om een Get-PSSession opdracht uit te voeren met de parameter ComputerName of ConnectionUri .

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Type:PSCredential
Position:Named
Default value:Current user
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Hiermee geeft u een matrix van sessie-id's. Met deze cmdlet worden alleen de sessies met de opgegeven id's opgehaald. Typ een of meer id's, gescheiden door komma's, of gebruik de bereikoperator (..) om een bereik van id's op te geven. U kunt de id-parameter niet gebruiken in combinatie met de parameter ComputerName .

Een id is een geheel getal dat de door de gebruiker beheerde sessies in de huidige sessie uniek identificeert. Het is gemakkelijker om te onthouden en te typen dan de InstanceId, maar deze is alleen uniek binnen de huidige sessie. De id van een sessie wordt opgeslagen in de eigenschap ID van de sessie.

Type:Int32[]
Position:0
Default value:All sessions
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-InstanceId

Hiermee geeft u een matrix van exemplaar-id's van sessies. Met deze cmdlet worden alleen de sessies met de opgegeven exemplaar-id's opgehaald.

De instantie-id is een GUID die een sessie op een lokale of externe computer uniek identificeert. De InstanceID is uniek, zelfs wanneer er meerdere sessies worden uitgevoerd in PowerShell.

De exemplaar-id van een sessie wordt opgeslagen in de eigenschap InstanceID van de sessie.

Type:Guid[]
Position:Named
Default value:All sessions
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Hiermee geeft u een matrix van sessienamen. Deze cmdlet haalt alleen de sessies op die de opgegeven beschrijvende namen hebben. Jokertekens zijn toegestaan.

De beschrijvende naam van een sessie wordt opgeslagen in de eigenschap Naam van de sessie.

Type:String[]
Position:Named
Default value:All sessions
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-Port

Hiermee geeft u de opgegeven netwerkpoort die wordt gebruikt voor de tijdelijke verbinding waarin de Get-PSSession opdracht wordt uitgevoerd. Als u verbinding wilt maken met een externe computer, moet de externe computer luisteren op de poort die de verbinding gebruikt. De standaardpoorten zijn 5985, de WinRM-poort voor HTTP en 5986, wat de WinRM-poort voor HTTPS is.

Voordat u een alternatieve poort gebruikt, moet u de WinRM-listener op de externe computer configureren om te luisteren op die poort. Als u de listener wilt configureren, typt u de volgende twee opdrachten bij de PowerShell-prompt:

Remove-Item -Path WSMan:\Localhost\listener\listener* -Recurse

New-Item -Path WSMan:\Localhost\listener -Transport http -Address * -Port \<port-number\>

Met deze parameter wordt geconfigureerd voor de tijdelijke verbinding die wordt gemaakt om een Get-PSSession opdracht uit te voeren met de parameter ComputerName of ConnectionUri .

Gebruik de parameter Poort niet, tenzij u dat moet doen. De poort die is ingesteld in de opdracht is van toepassing op alle computers of sessies waarop de opdracht wordt uitgevoerd. Een alternatieve poortinstelling kan verhinderen dat de opdracht op alle computers wordt uitgevoerd.

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Type:Int32
Position:Named
Default value:5985, 5986
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SessionOption

Hiermee geeft u geavanceerde opties voor de sessie. Voer een SessionOption-object in, bijvoorbeeld een object dat u maakt met behulp van de New-PSSessionOption cmdlet, of een hash-tabel waarin de sleutels namen van sessieopties zijn en de waarden sessieoptiewaarden zijn.

De standaardwaarden voor de opties worden bepaald door de waarde van de $PSSessionOption voorkeursvariabele, als deze is ingesteld. Anders worden de standaardwaarden vastgesteld door opties die zijn ingesteld in de sessieconfiguratie.

De sessieoptiewaarden hebben voorrang op standaardwaarden voor sessies die zijn ingesteld in de $PSSessionOption voorkeursvariabele en in de sessieconfiguratie. Ze hebben echter geen prioriteit boven maximumwaarden, quota of limieten die zijn ingesteld in de sessieconfiguratie.

Zie voor een beschrijving van de sessieopties, inclusief de standaardwaarden New-PSSessionOption. Zie about_Preference_Variables voor meer informatie over de$PSSessionOption voorkeursvariabele. Zie about_Session_Configurations (Engelstalig) voor meer informatie over sessieconfiguraties.

Type:PSSessionOption
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-State

Hiermee geeft u een sessiestatus. Deze cmdlet haalt alleen sessies op met de opgegeven status. De acceptabele waarden voor deze parameter zijn: All, Opened, Disconnected, Closeden Broken. De standaardwaarde is All.

De waarde van de sessiestatus is relatief ten opzichte van de huidige sessies. Sessies die niet zijn gemaakt in de huidige sessies en niet zijn verbonden met de huidige sessie, hebben een status van Disconnected zelfs wanneer ze zijn verbonden met een andere sessie.

De status van een sessie wordt opgeslagen in de eigenschap State van de sessie.

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Type:SessionFilterState
Accepted values:All, Opened, Disconnected, Closed, Broken
Position:Named
Default value:All
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ThrottleLimit

Hiermee geeft u het maximum aantal gelijktijdige verbindingen op dat tot stand kan worden gebracht om de Get-PSSession opdracht uit te voeren. Als u deze parameter weglaat of een waarde van 0 (nul) invoert, wordt de standaardwaarde , 32gebruikt. De beperkingslimiet is alleen van toepassing op de huidige opdracht, niet op de sessie of op de computer.

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Type:Int32
Position:Named
Default value:32
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseSSL

Geeft aan dat deze cmdlet het SSL-protocol (Secure Sockets Layer) gebruikt om de verbinding tot stand te brengen waarin de Get-PSSession opdracht wordt uitgevoerd. Standaard wordt SSL niet gebruikt. Als u deze parameter gebruikt, maar SSL niet beschikbaar is op de poort die voor de opdracht wordt gebruikt, mislukt de opdracht.

Met deze parameter configureert u de tijdelijke verbinding die wordt gemaakt om een Get-PSSession opdracht uit te voeren met de parameter ComputerName .

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMId

Hiermee geeft u een matrix van de id van virtuele machines. Deze cmdlet start een interactieve sessie met elk van de opgegeven virtuele machines. Gebruik de volgende opdracht om de virtuele machines te zien die voor u beschikbaar zijn:

Get-VM | Select-Object -Property Name, ID

Type:Guid[]
Aliases:VMGuid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMName

Hiermee geeft u een matrix met namen van virtuele machines. Deze cmdlet start een interactieve sessie met elk van de opgegeven virtuele machines. Gebruik Get-VM de cmdlet om de virtuele machines te zien die voor u beschikbaar zijn.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Invoerwaarden

None

U kunt geen objecten doorspezen naar deze cmdlet.

Uitvoerwaarden

PSSession

Notities

PowerShell bevat de volgende aliassen voor Get-PSSession:

  • Alle platformen:

    • gsn
  • Met deze cmdlet haalt u door de gebruiker beheerde sessies PSSession-objecten op, zoals de objecten die zijn gemaakt met behulp van de New-PSSessioncmdlets , Enter-PSSessionen Invoke-Command . De door het systeem beheerde sessie die wordt gemaakt wanneer u PowerShell start, wordt niet opgevraagd.

  • Vanaf Windows PowerShell 3.0 worden PSSession-objecten opgeslagen op de computer die zich aan de serverzijde of het ontvangende einde van een verbinding bevindt. Als u de sessies wilt ophalen die zijn opgeslagen op de lokale computer of een externe computer, brengt PowerShell een tijdelijke sessie tot stand op de opgegeven computer en voert u queryopdrachten uit in de sessie.

  • Als u sessies wilt ophalen die verbinding maken met een externe computer, gebruikt u de parameters ComputerNaam of ConnectionUri om de externe computer op te geven. Als u de sessies wilt filteren die Get-PSSession worden opgehaald, gebruikt u de parameters Name, ID, InstanceID en State . Gebruik de resterende parameters om de tijdelijke sessie te configureren die Get-PSSession wordt gebruikt.

  • Wanneer u de parameters ComputerName of ConnectionUri gebruikt, Get-PSSession worden alleen sessies opgehaald van computers met Windows PowerShell 3.0 en latere versies van PowerShell.

  • De waarde van de eigenschap State van een PSSession is relatief ten opzichte van de huidige sessie. Daarom betekent de waarde Verbroken dat de PSSession niet is verbonden met de huidige sessie. Dit betekent echter niet dat de PSSession is losgekoppeld van alle sessies. Het is mogelijk verbonden met een andere sessie. Gebruik de eigenschap Beschikbaarheid om te bepalen of u vanuit de huidige sessie verbinding kunt maken of opnieuw verbinding kunt maken met de PSSession.

De beschikbaarheidswaardeGeen geeft aan dat u verbinding kunt maken met de sessie. De waarde Bezet geeft aan dat u geen verbinding kunt maken met de PSSession omdat deze is verbonden met een andere sessie.

Zie RunspaceState Enumeration voor meer informatie over de waarden van de eigenschap State van sessies.

Zie RunspaceAvailability Enumeration voor meer informatie over de waarden van de eigenschap Beschikbaarheid van sessies.