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]
-InstanceId <Guid[]>
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[-ThrottleLimit <Int32>]
[-State <SessionFilterState>]
[-SessionOption <PSSessionOption>]
[<CommonParameters>]Get-PSSession
[-ConnectionUri] <Uri[]>
[-ConfigurationName <String>]
[-AllowRedirection]
[-Name <String[]>]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[-ThrottleLimit <Int32>]
[-State <SessionFilterState>]
[-SessionOption <PSSessionOption>]
[<CommonParameters>]Get-PSSession
[-ConfigurationName <String>]
[-Name <String[]>]
[-State <SessionFilterState>]
-ContainerId <String[]>
[<CommonParameters>]Get-PSSession
[-ConfigurationName <String>]
-InstanceId <Guid[]>
[-State <SessionFilterState>]
-ContainerId <String[]>
[<CommonParameters>]Get-PSSession
[-ConfigurationName <String>]
[-Name <String[]>]
[-State <SessionFilterState>]
-VMId <Guid[]>
[<CommonParameters>]Get-PSSession
[-ConfigurationName <String>]
-InstanceId <Guid[]>
[-State <SessionFilterState>]
-VMId <Guid[]>
[<CommonParameters>]Get-PSSession
[-ConfigurationName <String>]
[-Name <String[]>]
[-State <SessionFilterState>]
-VMName <String[]>
[<CommonParameters>]Get-PSSession
[-ConfigurationName <String>]
-InstanceId <Guid[]>
[-State <SessionFilterState>]
-VMName <String[]>
[<CommonParameters>]Get-PSSession
[-InstanceId <Guid[]>]
[<CommonParameters>]Get-PSSession
[-Id] <Int32[]>
[<CommonParameters>]Description
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 ComputerName of ConnectionUri parameters van Get-PSSession 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 alle sessies op die in de huidige sessie zijn gemaakt.
Gebruik de filterparameters, waaronder Name, Id, InstanceId, State, ApplicationNameen ConfigurationName- om een keuze te maken uit de sessies die Get-PSSession retourneert.
Gebruik de resterende parameters om de tijdelijke verbinding te configureren waarin de opdracht Get-PSSession wordt uitgevoerd wanneer u de parameters ComputerName of ConnectionUri gebruikt.
Notitie
In Windows PowerShell 2.0, zonder parameters, haalt Get-PSSession alle sessies op die zijn gemaakt in de huidige sessie. De parameter ComputerName haalt sessies op die in de huidige sessie zijn gemaakt en verbinding maken met de opgegeven computer.
Zie about_PSSessionsvoor meer informatie over PowerShell-sessies.
Voorbeelden
Voorbeeld 1: Sessies ophalen die zijn gemaakt in de huidige sessie
Get-PSSessionMet deze opdracht worden alle PSSessions 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 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 BusyMet deze opdracht worden de PSSessions 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 is 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-PSSessionIn dit voorbeeld ziet u hoe u de resultaten van een Get-PSSession opdracht in meerdere variabelen opslaat.
De eerste opdracht maakt gebruik van 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 PSSessionsop 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 $sIn dit voorbeeld ziet u hoe u een PSSession- kunt ophalen met behulp van de exemplaar-id en vervolgens de PSSession-verwijdert.
Met de eerste opdracht worden alle PSSessions die in de huidige sessie zijn gemaakt. Het verzendt de PSSessions naar de Format-Table cmdlet, waarin de ComputerName en InstanceId eigenschappen 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 Remove-PSSession cmdlet 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 AvailableMet 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 is None, wat aangeeft dat deze niet in gebruik is.
De tweede opdracht maakt gebruik van de Get-PSSession cmdlet om naar de BackupJob04 sessie en de Connect-PSSession cmdlet om verbinding te maken met de sessie. Met de opdracht wordt de sessie opgeslagen in de variabele $s.
De derde opdracht haalt de sessie op in de variabele $s. In de uitvoer ziet u dat de opdracht Connect-PSSession is geslaagd. De sessie bevindt zich in de status Geopend en is beschikbaar voor gebruik.
Voorbeeld 7: Een sessie ophalen met behulp van de bijbehorende id
Get-PSSession -Id 2Met deze opdracht wordt de PSSession- met id-2. Omdat de waarde van de eigenschap Id 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 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 voor het verifiëren van referenties 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 acceptabele waarden voor deze parameter zijn:
DefaultBasicCredSSPDigestKerberosNegotiate-
NegotiateWithImplicitCredential.
De standaardwaarde is Default.
Zie Opsomming AuthenticationMechanismvoor meer informatie over de waarden van deze parameter.
Voorzichtigheid
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 van 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 Cert:-station.
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, localhostof een 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_Configurationsvoor 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, Porten ApplicationName parameters 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 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 AllowRedirection parameter 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 opdracht docker ps 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. De standaardwaarde is 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 een SecureString-.
Notitie
Zie voor meer informatie over SecureString gegevensbeveiliging Hoe veilig is SecureString?.
Deze parameter configureert 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 parameter Id 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 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 eigenschap Id 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 Name 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\>
Deze parameter configureert de tijdelijke verbinding die wordt gemaakt om een Get-PSSession opdracht uit te voeren met de parameter ComputerName of ConnectionUri.
Gebruik de parameter Port niet, tenzij u dit moet doen. De Poort 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 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 New-PSSessionOptionvoor een beschrijving van de sessieopties, inclusief de standaardwaarden.
Zie $PSSessionOptionvoor meer informatie over de voorkeursvariabele. Zie about_Session_Configurationsvoor 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, 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 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 State 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 opdracht Get-PSSession uit te voeren. Als u deze parameter weglaat of een waarde invoert van 0 (nul), wordt de standaardwaarde, 32, gebruikt. 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 gebruikmaakt van het SSL-protocol (Secure Sockets Layer) om de verbinding tot stand te brengen waarin de Get-PSSession opdracht wordt uitgevoerd. SSL wordt standaard 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 cmdlet Get-VM 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
Notities
Windows PowerShell bevat de volgende aliassen voor Get-PSSession:
gsnMet deze cmdlet worden door de gebruiker beheerde sessies PSSession--objecten opgehaald, zoals sessies die zijn gemaakt met behulp van de
New-PSSession,Enter-PSSessionenInvoke-Commandcmdlets. 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. Als u de sessies wilt filteren die
Get-PSSessionophaalt, gebruikt u de parameters Name, Id, InstanceIden State. Gebruik de resterende parameters om de tijdelijke sessie te configureren dieGet-PSSessiongebruikt.Wanneer u de parameters ComputerName of ConnectionUri gebruikt, krijgt
Get-PSSessionalleen sessies 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 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. Als u wilt bepalen of u verbinding kunt maken met de PSSession- vanuit de huidige sessie, gebruikt u de eigenschap Beschikbaarheid.
Een beschikbaarheidswaarde van Geen geeft aan dat u verbinding kunt maken met de sessie. Een waarde van Bezet geeft aan dat u geen verbinding kunt maken met de PSSession- omdat deze is verbonden met een andere sessie.
Zie RunspaceState-opsommingvoor meer informatie over de waarden van de eigenschap State van sessies.
Zie Opsomming RunspaceAvailabilityvoor meer informatie over de waarden van de eigenschap Availability van sessies.
