Get-PSSession
Hiermee haalt u de Windows 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
[-InstanceId <Guid[]>]
[<CommonParameters>]Get-PSSession
[-Id] <Int32[]>
[<CommonParameters>]Description
De cmdlet Get-PSSession 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 zijn gemaakt in de huidige sessie.
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.
OPMERKING: In Windows PowerShell 2.0, zonder parameters, Get-PSSession alle sessies krijgt 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 de status Verbinding verbroken en beschikbaarheid bezet hebben. Ze zijn gemaakt in verschillende sessies en zijn momenteel in gebruik. De ScheduledJobs-sessie, geopend en beschikbaar, 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 Opdracht Get-PSSession in meerdere variabelen opslaat.
De eerste opdracht maakt gebruik van de cmdlet New-PSSession 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 cmdlet Get-PSSession 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 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 verzameld die beginnen met BackupJob en de CONFIGURATIE van de ITTasks-sessie 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 cmdlet Get-PSSession 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 geen is, 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 $s variabele. 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: https://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 opdracht Get-PSSession uit te voeren met de parameter ComputerName of ConnectionUri.
De acceptabele waarden voor deze parameter zijn:
- Verstek
- Basisch
- Credssp
- Verteren
- Kerberos
- Onderhandelen
- NegotiateWithImplicitCredential.
De standaardwaarde is Standaard.
Zie Opsomming AuthenticationMechanism in de MSDN-bibliotheek 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 van de digitale openbare sleutel (X509) van een gebruikersaccount dat gemachtigd is 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 opdracht Get-PSSession 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-certificaat: 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 Opdracht Get-PSSession 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, localhost of een punt (.).
Opmerking: met deze parameter worden alleen sessies opgehaald van computers met Windows PowerShell 3.0 of hoger 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: https://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 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>:<Poort>/<ApplicationName->
De standaardwaarde is: https://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 |
-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, Domain01\User01of User@Domain.com, of voer een PSCredential--object in, zoals een object dat wordt geretourneerd door de Get-Credential-cmdlet.
Wanneer u een gebruikersnaam typt, wordt u door deze cmdlet gevraagd om een wachtwoord.
Met deze parameter configureert u de tijdelijke verbinding die wordt gemaakt om een Opdracht Get-PSSession 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 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 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 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\>
Met deze parameter configureert u de tijdelijke verbinding die wordt gemaakt om een Opdracht Get-PSSession 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 about_Preference_Variablesvoor meer informatie over de $PSSessionOption 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: Alle, Geopend, Verbroken, Gesloten en Verbroken. De standaardwaarde is Alles.
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 de status Verbinding verbroken, 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 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, 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 opdracht Get-PSSession 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 |
Invoerwaarden
None
U kunt invoer voor deze cmdlet niet doorsluisen.
Uitvoerwaarden
Notities
- Met deze cmdlet worden door de gebruiker beheerde sessies PSSession--objecten opgehaald, zoals de sessies die zijn gemaakt met behulp van de cmdlet 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. Als u de sessies wilt filteren die Get-PSSession ontvangt, gebruikt u de parameters Name, ID, InstanceIDen State. Gebruik de resterende parameters om de tijdelijke sessie te configureren die Get-PSSession gebruikt.
- Wanneer u de parameters ComputerName of ConnectionUri gebruikt, krijgt Get-PSSession- alleen 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.