Connect-PSSession
Maakt opnieuw verbinding met niet-verbonden sessies.
Syntax
Connect-PSSession
-Name <String[]>
[-ThrottleLimit <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Connect-PSSession
[-Session] <PSSession[]>
[-ThrottleLimit <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Connect-PSSession
-ComputerName <String[]>
[-ApplicationName <String>]
[-ConfigurationName <String>]
-InstanceId <Guid[]>
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[-Port <Int32>]
[-UseSSL]
[-SessionOption <PSSessionOption>]
[-ThrottleLimit <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Connect-PSSession
-ComputerName <String[]>
[-ApplicationName <String>]
[-ConfigurationName <String>]
[-Name <String[]>]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[-Port <Int32>]
[-UseSSL]
[-SessionOption <PSSessionOption>]
[-ThrottleLimit <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Connect-PSSession
[-ConfigurationName <String>]
[-ConnectionUri] <Uri[]>
[-AllowRedirection]
-InstanceId <Guid[]>
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[-SessionOption <PSSessionOption>]
[-ThrottleLimit <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Connect-PSSession
[-ConfigurationName <String>]
[-ConnectionUri] <Uri[]>
[-AllowRedirection]
[-Name <String[]>]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[-SessionOption <PSSessionOption>]
[-ThrottleLimit <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Connect-PSSession
-InstanceId <Guid[]>
[-ThrottleLimit <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Connect-PSSession
[-ThrottleLimit <Int32>]
[-Id] <Int32[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
De cmdlet Connect-PSSession maakt opnieuw verbinding met door de gebruiker beheerde Windows PowerShell-sessies (PSSessions) die zijn losgekoppeld. Het werkt op sessies die opzettelijk zijn verbroken, bijvoorbeeld met behulp van de cmdlet Disconnect-PSSession of de parameter InDisconnectedSession van de Invoke-Command cmdlet, en sessies die onbedoeld zijn losgekoppeld, zoals door een tijdelijke netwerkstoring.
Connect-PSSession kan verbinding maken met elke niet-verbonden sessie die door dezelfde gebruiker is gestart. Deze omvatten de sessies die zijn gestart door of zijn losgekoppeld van andere sessies op andere computers.
Connect-PSSession kan echter geen verbinding maken met verbroken of gesloten sessies, of interactieve sessies die zijn gestart met behulp van de cmdlet Enter-PSSession. U kunt ook geen sessies verbinden met sessies die zijn gestart door andere gebruikers, tenzij u de referenties kunt opgeven van de gebruiker die de sessie heeft gemaakt.
Zie about_Remote_Disconnected_Sessions voor meer informatie over de functie Niet-verbonden sessies.
Deze cmdlet is geïntroduceerd in Windows PowerShell 3.0.
Voorbeelden
Voorbeeld 1: Opnieuw verbinding maken met een sessie
PS C:\> Connect-PSSession -ComputerName Server01 -Name ITTask
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
4 ITTask Server01 Opened ITTasks Available
Met deze opdracht wordt opnieuw verbinding gemaakt met de ITTask-sessie op de Server01-computer.
De uitvoer laat zien dat de opdracht is geslaagd. De status van de sessie is Geopend en de beschikbaarheid is Beschikbaar, wat aangeeft dat u opdrachten in de sessie kunt uitvoeren.
Voorbeeld 2: Effect van het verbreken en opnieuw verbinden
PS C:\> Get-PSSession
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
1 Backups Localhost Opened Microsoft.PowerShell Available
PS C:\> Get-PSSession | Disconnect-PSSession
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
1 Backups Localhost Disconnected Microsoft.PowerShell None
PS C:\> Get-PSSession | Connect-PSSession
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
1 Backups Localhost Opened Microsoft.PowerShell Available
In dit voorbeeld ziet u het effect van het verbreken van de verbinding en het opnieuw verbinden met een sessie.
De eerste opdracht maakt gebruik van de cmdlet Get-PSSession. Zonder de parameter ComputerName haalt de opdracht alleen sessies op die in de huidige sessie zijn gemaakt.
In de uitvoer ziet u dat de opdracht de back-upssessie op de lokale computer ophaalt. De status van de sessie is Geopend en de beschikbaarheid is Beschikbaar.
De tweede opdracht gebruikt de cmdlet Get-PSSession om de PSSession-objecten op te halen die in de huidige sessie zijn gemaakt en de cmdlet Disconnect-PSSession om de sessies te verbreken. In de uitvoer ziet u dat de verbinding met de back-upsessie is verbroken. De status van de sessie is Verbroken en de beschikbaarheid is Geen.
De derde opdracht gebruikt de cmdlet Get-PSSession om de PSSession-objecten op te halen die in de huidige sessie zijn gemaakt en de cmdlet Connect-PSSession om de sessies opnieuw te verbinden. In de uitvoer ziet u dat de back-upssessie opnieuw is verbonden. De status van de sessie is Geopend en de beschikbaarheid is Beschikbaar.
Als u de cmdlet Connect-PSSession gebruikt voor een sessie die niet is losgekoppeld, heeft de opdracht geen invloed op de sessie en genereert deze geen fouten.
Voorbeeld 3: Reeks opdrachten in een ondernemingsscenario
The administrator starts by creating a sessions on a remote computer and running a script in the session.The first command uses the **New-PSSession** cmdlet to create the ITTask session on the Server01 remote computer. The command uses the *ConfigurationName* parameter to specify the ITTasks session configuration. The command saves the sessions in the $s variable.
PS C:\> $s = New-PSSession -ComputerName Server01 -Name ITTask -ConfigurationName ITTasks
The second command **Invoke-Command** cmdlet to start a background job in the session in the $s variable. It uses the *FilePath* parameter to run the script in the background job.
PS C:\> Invoke-Command -Session $s {Start-Job -FilePath \\Server30\Scripts\Backup-SQLDatabase.ps1}
Id Name State HasMoreData Location Command
-- ---- ----- ----------- -------- -------
2 Job2 Running True Server01 \\Server30\Scripts\Backup...
The third command uses the Disconnect-PSSession cmdlet to disconnect from the session in the $s variable. The command uses the *OutputBufferingMode* parameter with a value of Drop to prevent the script from being blocked by having to deliver output to the session. It uses the *IdleTimeoutSec* parameter to extend the session time-out to 15 hours.When the command is completed, the administrator locks her computer and goes home for the evening.
PS C:\> Disconnect-PSSession -Session $s -OutputBufferingMode Drop -IdleTimeoutSec 60*60*15
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
1 ITTask Server01 Disconnected ITTasks None
Later that evening, the administrator starts her home computer, logs on to the corporate network, and starts Windows PowerShell. The fourth command uses the Get-PSSession cmdlet to get the sessions on the Server01 computer. The command finds the ITTask session.The fifth command uses the **Connect-PSSession** cmdlet to connect to the ITTask session. The command saves the session in the $s variable.
PS C:\> Get-PSSession -ComputerName Server01 -Name ITTask
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
1 ITTask Server01 Disconnected ITTasks None
PS C:\> $s = Connect-PSSession -ComputerName Server01 -Name ITTask
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
1 ITTask Server01 Opened ITTasks Available
The sixth command uses the **Invoke-Command** cmdlet to run a Get-Job command in the session in the $s variable. The output shows that the job finished successfully.The seventh command uses the **Invoke-Command** cmdlet to run a Receive-Job command in the session in the $s variable in the session. The command saves the results in the $BackupSpecs variable.The eighth command uses the **Invoke-Command** cmdlet to runs another script in the session. The command uses the value of the $BackupSpecs variable in the session as input to the script.
PS C:\> Invoke-Command -Session $s {Get-Job}
Id Name State HasMoreData Location Command
-- ---- ----- ----------- -------- -------
2 Job2 Completed True Server01 \\Server30\Scripts\Backup...
PS C:\> Invoke-Command -Session $s {$BackupSpecs = Receive-Job -JobName Job2}
PS C:\> Invoke-Command -Session $s {\\Server30\Scripts\New-SQLDatabase.ps1 -InitData $BackupSpecs.Initialization}
The ninth command disconnects from the session in the $s variable.The administrator closes Windows PowerShell and closes the computer. She can reconnect to the session on the next day and check the script status from her work computer.
PS C:\> Disconnect-PSSession -Session $s -OutputBufferingMode Drop -IdleTimeoutSec 60*60*15
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
1 ITTask Server01 Disconnected ITTasks None
Deze reeks opdrachten laat zien hoe de cmdlet Connect-PSSession kan worden gebruikt in een ondernemingsscenario. In dit geval start een systeembeheerder een langlopende taak in een sessie op een externe computer. Nadat de taak is gestart, verbreekt de beheerder de verbinding met de sessie en gaat hij naar huis. Later die avond meldt de beheerder zich aan bij haar thuiscomputer en controleert hij of de taak is uitgevoerd totdat deze is voltooid.
Parameters
-AllowRedirection
Geeft aan dat deze cmdlet omleiding van deze verbinding naar een alternatieve URI toestaat.
Wanneer u de parameter ConnectionURI gebruikt, kan de externe bestemming een instructie retourneren om om te leiden naar een andere URI. Standaard leidt Windows PowerShell verbindingen niet om, maar u kunt deze parameter gebruiken om de verbinding om te leiden.
U kunt ook het aantal keren dat de verbinding wordt omgeleid, beperken door de sessiewaarde MaximumConnectionRedirectionCount te wijzigen. Gebruik de parameter MaximumRedirection van de cmdlet New-PSSessionOption of stel de eigenschap MaximumConnectionRedirectionCount van de $PSSessionOption voorkeursvariabele in. De standaardwaarde is 5.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
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: 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: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Authentication
Hiermee geeft u het mechanisme op dat wordt gebruikt voor het verifiëren van gebruikersreferenties in de opdracht om opnieuw verbinding te maken met de niet-verbonden sessie. De aanvaardbare waarden voor deze parameter zijn:
- Standaard
- Basic
- Credssp
- Samenvatting
- Kerberos
- Negotiate
- NegotiateWithImplicitCredential
De standaardwaarde is Standaard.
Zie AuthenticationMechanism Enumeration in de MSDN-bibliotheek voor meer informatie over de waarden van deze parameter.
Waarschuwing: Verificatie van referentiebeveiligingsondersteuningsprovider (CredSSP), 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 externe computer worden doorgegeven, worden gebruikt om de netwerksessie te beheren.
Type: | AuthenticationMechanism |
Accepted values: | Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CertificateThumbprint
Hiermee geeft u het certificaat voor de digitale openbare sleutel (X509) van een gebruikersaccount dat is gemachtigd om verbinding te maken met de niet-verbonden sessie. Voer de vingerafdruk van het certificaat in.
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 certificaatvingerafdruk wilt ophalen, gebruikt u een Get-Item of Get-ChildItem opdracht in het station Windows PowerShell Cert: .
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ComputerName
Hiermee geeft u de computers waarop de niet-verbonden sessies worden opgeslagen. Sessies worden opgeslagen op de computer die zich aan de serverzijde of het ontvangende einde van een verbinding bevindt. Standaard is dit de lokale computer.
Typ de NetBIOS-naam, een IP-adres of een volledig gekwalificeerde domeinnaam van één computer. Jokertekens zijn niet toegestaan. Als u de lokale computer wilt opgeven, typt u de computernaam, localhost of een punt (.)
Type: | String[] |
Aliases: | Cn |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConfigurationName
Maakt alleen verbinding met 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_Configurations (Engelstalig) voor meer informatie over sessieconfiguraties.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConnectionUri
Hiermee geeft u de URI's van de verbindingseindpunten voor de niet-verbonden sessies.
De URI moet volledig zijn gekwalificeerd. De indeling van deze tekenreeks is als volgt:
\<Transport\>://\<ComputerName\>:\<Port\>/\<ApplicationName\>
De standaardwaarde is als volgt:
https://localhost:5985/WSMAN
Als u geen verbindings-URI opgeeft, kunt u de parameters UseSSL en Port gebruiken om de verbindings-URI-waarden op te geven.
Geldige waarden voor het segment Transport van de URI zijn HTTP en HTTPS. Als u een verbindings-URI met een Transport-segment opgeeft, maar geen poort opgeeft, wordt de sessie gemaakt met standaardpoorten: 80 voor HTTP en 443 voor HTTPS. Als u de standaardpoorten voor Windows PowerShell externe toegang wilt gebruiken, geeft u poort 5985 op voor HTTP of 5986 voor HTTPS.
Als de doelcomputer de verbinding omleidt naar een andere URI, voorkomt Windows PowerShell de omleiding, tenzij u de parameter AllowRedirection in de opdracht gebruikt.
Type: | Uri[] |
Aliases: | URI, CU |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Credential
Hiermee geeft u een gebruikersaccount op dat is gemachtigd om verbinding te maken met de niet-verbonden sessie. Standaard is dit de huidige gebruiker.
Typ een gebruikersnaam, zoals Gebruiker01 of Domein01\Gebruiker01. Of voer een PSCredential-object in, zoals een object dat is gegenereerd door de cmdlet Get-Credential. Als u een gebruikersnaam typt, wordt u met deze cmdlet gevraagd om een wachtwoord.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
Hiermee geeft u de id's van de niet-verbonden sessies. De parameter Id werkt alleen wanneer de niet-verbonden sessie eerder is verbonden met de huidige sessie.
Deze parameter is geldig, maar niet effectief, wanneer de sessie is opgeslagen op de lokale computer, maar niet is verbonden met de huidige sessie.
Type: | Int32[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InstanceId
Hiermee geeft u de exemplaar-id's van de niet-verbonden sessies.
De instantie-id is een GUID die een PSSession op een lokale of externe computer uniek identificeert.
De exemplaar-id wordt opgeslagen in de eigenschap InstanceID van de PSSession.
Type: | Guid[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Hiermee geeft u de beschrijvende namen van de niet-verbonden sessies.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Port
Hiermee geeft u de netwerkpoort op de externe computer die wordt gebruikt om opnieuw verbinding te maken met de sessie. 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, de WinRM-poort voor HTTPS.
Voordat u een alternatieve poort gebruikt, moet u de WinRM-listener op de externe computer configureren om op die poort te luisteren. Als u de listener wilt configureren, typt u de volgende twee opdrachten bij de Windows PowerShell prompt:
Remove-Item -Path WSMan:\Localhost\listener\listener* -Recurse
New-Item -Path WSMan:\Localhost\listener -Transport http -Address * -Port \<port-number\>
Gebruik de poortparameter 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.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Session
Hiermee geeft u de niet-verbonden sessies op. Voer een variabele in die de PSSession-objecten bevat of een opdracht waarmee de PSSession-objecten worden gemaakt of opgehaald, zoals een Get-PSSession opdracht.
Type: | PSSession[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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 cmdlet New-PSSessionOption, of een hashtabel 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 bepaald door opties die zijn ingesteld in de sessieconfiguratie.
De waarden van de sessieoptie hebben voorrang op standaardwaarden voor sessies die zijn ingesteld in de voorkeursvariabele $PSSessionOption en in de sessieconfiguratie. Ze hebben echter geen voorrang op maximumwaarden, quota of limieten die zijn ingesteld in de sessieconfiguratie.
Zie New-PSSessionOption voor een beschrijving van de sessieopties die de standaardwaarden bevatten. Zie about_Preference_Variables voor meer informatie over de voorkeursvariabele $PSSessionOption. 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 |
-ThrottleLimit
Hiermee geeft u het maximum aantal gelijktijdige verbindingen dat tot stand kan worden gebracht om deze opdracht uit te voeren. Als u deze parameter weglaat of een waarde van 0 invoert, wordt de standaardwaarde 32 gebruikt.
De beperkingslimiet is alleen van toepassing op de huidige opdracht, niet op de sessie of op de computer.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseSSL
Geeft aan dat deze cmdlet het SSL-protocol (Secure Sockets Layer) gebruikt om verbinding te maken met de niet-verbonden sessie. Standaard wordt SSL niet gebruikt.
WS-Management versleutelt alle Windows PowerShell inhoud die via het netwerk wordt verzonden. De parameter UseSSL is een extra beveiliging waarmee de gegevens worden verzonden via een HTTPS-verbinding in plaats van een HTTP-verbinding.
Als u deze parameter gebruikt, maar SSL niet beschikbaar is op de poort die wordt gebruikt voor de opdracht, mislukt de opdracht.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Invoerwaarden
U kunt een sessie (PSSession) doorsluizen naar deze cmdlet.
Uitvoerwaarden
Deze cmdlet retourneert een object dat de sessie vertegenwoordigt waarmee opnieuw verbinding is gemaakt.
Notities
Connect-PSSession maakt alleen opnieuw verbinding met sessies die zijn verbroken, dat wil gezegd, sessies met de waarde Verbroken voor de eigenschap Status . Alleen sessies die zijn verbonden met of eindigen op computers waarop Windows PowerShell 3.0 of latere versies worden uitgevoerd, kunnen worden losgekoppeld en opnieuw worden verbonden.
Als u Connect-PSSession gebruikt voor een sessie die niet is verbroken, heeft de opdracht geen invloed op de sessie en genereert deze geen fouten.
Losgekoppelde loopbacksessies met interactieve tokens, die worden gemaakt met behulp van de parameter EnableNetworkAccess , kunnen alleen opnieuw worden verbonden vanaf de computer waarop de sessie is gemaakt. Deze beperking beschermt de computer tegen schadelijke toegang.
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 verbinding kunt maken of opnieuw verbinding kunt maken met de sessie.
De beschikbaarheidswaarde Geen 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 in de MSDN-bibliotheek voor meer informatie over de waarden van de eigenschap State van sessies.
Zie RunspaceAvailability Enumeration in de MSDN-bibliotheek voor meer informatie over de waarden van de eigenschap Beschikbaarheid van sessies.
U kunt de time-outwaarde voor inactiviteit van een PSSession niet wijzigen wanneer u verbinding maakt met de PSSession. De parameter SessionOption van Connect-PSSession gebruikt een SessionOption-object met de waarde IdleTimeout . De waarde IdleTimeout van het object SessionOption en de waarde IdleTimeout van de variabele $PSSessionOption worden echter genegeerd wanneer u verbinding maakt met een PSSession.
U kunt de time-out voor inactiviteit van een PSSession instellen en wijzigen wanneer u de PSSession maakt, met behulp van de cmdlet New-PSSession of Invoke-Command en wanneer u de verbinding met de PSSession verbreekt.
De eigenschap IdleTimeout van een PSSession is essentieel voor niet-verbonden sessies, omdat deze bepaalt hoe lang een niet-verbonden sessie wordt onderhouden op de externe computer. Niet-verbonden sessies worden beschouwd als niet-actief vanaf het moment dat de verbinding wordt verbroken, zelfs als opdrachten worden uitgevoerd in de niet-verbonden sessie.
Verwante koppelingen
- Disconnect-PSSession
- Enter-PSSession
- Exit-PSSession
- Get-PSSession
- Get-PSSessionConfiguration
- New-PSSession
- New-PSSessionOption
- New-PSTransportOption
- Receive-PSSession
- Register-PSSessionConfiguration
- Remove-PSSession
- about_PSSessions
- about_Remote
- about_Remote_Disconnected_Sessions
- about_Session_Configurations