Delen via


Get-PSSession

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

Syntaxis

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 op lokale en externe computers.

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

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

Gebruik de filterparameters, waaronder Name, ID, InstanceID, State, ApplicationName en ConfigurationName , om een selectie te maken uit de sessies die worden Get-PSSession 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, zonder parameters, Get-PSSession worden alle sessies opgevraagd die in de huidige sessie zijn gemaakt. De parameter ComputerName haalt sessies op die zijn gemaakt in de huidige sessie en maak verbinding met de opgegeven computer.

Zie about_PSSessions voor meer informatie over PowerShell-sessies.

Voorbeelden

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

Get-PSSession

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

Voorbeeld 2: Sessies ophalen die zijn verbonden met de lokale computer

Get-PSSession -ComputerName "localhost"

Met deze opdracht worden de PSSessions ophaalt 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 ophalen die zijn verbonden 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 worden de PSSessions ophaalt 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 zijn momenteel in gebruik. De ScheduledJobs sessie, die wil Opened en Available, is gemaakt in de huidige sessie.

Voorbeeld 4: 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 gebruikt een Get-PSSession cmdlet om de drie PSSessions op te halen. Vervolgens wordt elk van de PSSessions opgeslagen in een afzonderlijke variabele.

Wanneer PowerShell een matrix met objecten toewijst aan een matrix met variabelen, wordt het eerste object toegewezen aan de eerste variabele, het tweede object aan de tweede variabele, enzovoort. Als er meer objecten zijn dan variabelen, worden alle resterende objecten toegewezen aan de laatste variabele in de matrix. Als er meer variabelen zijn dan objecten, 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 exemplaar-id en vervolgens de PSSession verwijdert.

De eerste opdracht haalt alle PSSessions op die in de huidige sessie zijn gemaakt. Hiermee worden de PSSessions 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 maakt gebruik van de cmdlet Remove-PSSession om de PSSession in de $s variabele te verwijderen.

Voorbeeld 6: Een sessie ophalen met een bepaalde naam

De opdrachten in dit voorbeeld zoeken een sessie met een bepaalde naamindeling en gebruiken een bepaalde sessieconfiguratie en maken vervolgens verbinding met de sessie. U kunt een opdracht zoals deze gebruiken om een sessie te vinden waarin een collega een taak heeft gestart en verbinding maakt 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 Server02- en Server12-computers 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 hash-tabel 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. In de uitvoer ziet u dat de opdracht de BackupJob04 sessie retourneert. De verbinding met de sessie is verbroken en de beschikbaarheid isNone, 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. In de uitvoer ziet u 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 2ophaalt. Omdat de waarde van de id-eigenschap alleen uniek is in de huidige sessie, is de id-parameter alleen geldig voor lokale opdrachten.

Parameters

-AllowRedirection

Geeft aan dat deze cmdlet omleiding van deze verbinding met een alternatieve URI (Uniform Resource Identifier) toestaat. PowerShell leidt standaard geen verbindingen om.

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
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren: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.

Let op

CredSSP-verificatie (Credential Security Support Provider), waarbij de referenties van de gebruiker worden doorgegeven aan een externe computer die moet worden geverifieerd, is ontworpen voor opdrachten waarvoor verificatie is vereist voor meer dan één resource, zoals toegang tot een externe netwerkshare. Dit mechanisme verhoogt het beveiligingsrisico van de externe bewerking. Als de externe computer is aangetast, 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
Geaccepteerde waarden:Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos
Position:Named
Default value:Default
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-CertificateThumbprint

Hiermee geeft u het certificaat voor de digitale openbare sleutel (X509) van een gebruikersaccount dat is gemachtigd om de sessie te maken 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 een Get-Item of Get-ChildItem opdracht in het PowerShell-station Cert: .

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ComputerName

Hiermee geeft u een matrix van 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 einde van elke verbinding. Als u de sessies op de opgegeven computers wilt ophalen, maakt PowerShell een tijdelijke verbinding met elke computer en voert u een Get-PSSession opdracht uit.

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 of localhosteen punt (.).

Notitie

Met deze parameter worden alleen sessies opgehaald van computers met Windows PowerShell 3.0 of nieuwere versies van PowerShell. Eerdere versies slaan geen sessies op.

Type:String[]
Aliassen:Cn
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren: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 voorafgegaan: 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
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ConnectionUri

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

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

De notatie 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 standaardenpoorten: 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 alleen sessies opgehaald van computers met Windows PowerShell 3.0 of hoger van Windows PowerShell. Eerdere versies slaan geen sessies op.

Type:Uri[]
Aliassen:URI, CU
Position:0
Default value:Http://localhost:5985/WSMAN
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ContainerId

Hiermee geeft u een matrix van id's van containers. Met deze cmdlet wordt een interactieve sessie gestart 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
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Credential

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

Typ een gebruikersnaam, zoals User01 of Domain01\User01, of voer een PSCredential-object in dat is gegenereerd door de Get-Credential cmdlet. 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 SecureString.

Notitie

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

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 .

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Type:PSCredential
Position:Named
Default value:Current user
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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 samen met de parameter ComputerName gebruiken.

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 het is alleen uniek binnen de huidige sessie. De id van een sessie wordt opgeslagen in de id-eigenschap van de sessie.

Type:Int32[]
Position:0
Default value:All sessions
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren: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 exemplaar-id is een GUID waarmee een sessie op een lokale of externe computer uniek wordt geïdentificeerd. 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
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Hiermee geeft u een matrix van sessienamen. Met deze cmdlet worden alleen de sessies met de opgegeven beschrijvende namen ophaalt. 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
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren: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 door de verbinding wordt gebruikt. De standaardpoorten zijn 5985, de WinRM-poort voor HTTP en 5986, de WinRM-poort voor HTTPS.

Voordat u een alternatieve poort gebruikt, moet u de WinRM-listener op de externe computer configureren om naar die poort te luisteren. 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 configureert u de tijdelijke verbinding die wordt gemaakt om een Get-PSSession opdracht uit te voeren met de parameter ComputerName of ConnectionUri .

Gebruik de poortparameter alleen als u dit moet doen. De poortset in de opdracht is van toepassing op alle computers of sessies waarop de opdracht wordt uitgevoerd. Een alternatieve poortinstelling kan verhinderen dat de opdracht wordt uitgevoerd op alle computers.

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Type:Int32
Position:Named
Default value:5985, 5986
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SessionOption

Hiermee geeft u geavanceerde opties voor de sessie. Voer een SessionOption-object in, zoals 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 ingesteld op basis van opties die zijn ingesteld in de sessieconfiguratie.

De waarden voor sessieopties hebben voorrang op standaardwaarden voor sessies die zijn ingesteld in de $PSSessionOption voorkeursvariabele en in de sessieconfiguratie. Ze hebben echter geen voorrang op 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
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-State

Hiermee geeft u een sessiestatus. Met deze cmdlet worden alleen sessies met de opgegeven status opgeslagen. De acceptabele waarden voor deze parameter zijn: All, Opened, Disconnected, , en BrokenClosed. 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 die 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 Status van de sessie.

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Type:SessionFilterState
Geaccepteerde waarden:All, Opened, Disconnected, Closed, Broken
Position:Named
Default value:All
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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 invoert van 0 (nul), 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
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-VMId

Hiermee geeft u een matrix van id van virtuele machines. Met deze cmdlet wordt een interactieve sessie gestart met elk van de opgegeven virtuele machines. Gebruik de volgende opdracht om de virtuele machines weer te geven die voor u beschikbaar zijn:

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

Type:Guid[]
Aliassen:VMGuid
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-VMName

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

Type:String[]
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Invoerwaarden

None

U kunt geen objecten doorsluisen naar deze cmdlet.

Uitvoerwaarden

PSSession

Notities

PowerShell bevat de volgende aliassen voor Get-PSSession:

  • Alle platformen:

    • gsn
  • Met deze cmdlet worden door de gebruiker beheerde sessies PSSession-objecten opgehaald, zoals die worden gemaakt met behulp van de New-PSSession, Enter-PSSessionen Invoke-Command cmdlets. De sessie die door het systeem wordt beheerd, wordt niet weergegeven wanneer u PowerShell start.

  • Vanaf Windows PowerShell 3.0 worden PSSession-objecten opgeslagen op de computer die zich aan de serverzijde bevindt of het ontvangen van een verbinding. 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 ComputerName of ConnectionUri om de externe computer op te geven. Gebruik de parameters Name, ID, InstanceID en State om de sessies te filteren die worden Get-PSSession ophaalt. 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 een waarde van Verbinding verbroken dat de PSSession niet is verbonden met de huidige sessie. Het betekent echter niet dat de PSSession is losgekoppeld van alle sessies. Het kan zijn dat deze is verbonden met een andere sessie. Gebruik de eigenschap Beschikbaarheid om te bepalen of u vanuit de huidige sessie verbinding kunt maken met de PSSession of opnieuw verbinding kunt maken met de PSSession.

Een beschikbaarheidswaarde van None geeft aan dat u verbinding kunt maken met de sessie. Een waarde bezet geeft aan dat u geen verbinding kunt maken met de PSSession omdat deze is verbonden met een andere sessie.

Zie RunspaceState-opsomming voor meer informatie over de waarden van de eigenschap Status van sessies.

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