Connect-PSSession

Connect-PSSession
    -Name <String[]>
    [-ThrottleLimit <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Connect-PSSession
    [-Session] <PSSession[]>
    [-ThrottleLimit <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Connect-PSSession
    -ComputerName <String[]>
    -InstanceId <Guid[]>
    [-ApplicationName <String>]
    [-ConfigurationName <String>]
    [-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
    [-ConnectionUri] <Uri[]>
    -InstanceId <Guid[]>
    [-ConfigurationName <String>]
    [-AllowRedirection]
    [-Credential <PSCredential>]
    [-Authentication <AuthenticationMechanism>]
    [-CertificateThumbprint <String>]
    [-SessionOption <PSSessionOption>]
    [-ThrottleLimit <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Connect-PSSession
    [-ConnectionUri] <Uri[]>
    [-ConfigurationName <String>]
    [-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
    [-Id] <Int32[]>
    [-ThrottleLimit <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Deze cmdlet is alleen beschikbaar op het Windows-platform.

De Connect-PSSession cmdlet maakt opnieuw verbinding met door de gebruiker beheerde PowerShell-sessies (PSSessions) die zijn losgekoppeld. Het werkt op sessies die opzettelijk worden losgekoppeld, zoals met behulp van de cmdlet Disconnect-PSSession of de InDisconnectedSession-parameter van de Invoke-Command-cmdlet, en de sessies die onbedoeld zijn verbroken, zoals door een tijdelijke netwerkstoring.

Connect-PSSession kan verbinding maken met elke niet-verbonden sessie die door dezelfde gebruiker is gestart. Dit zijn de sessies die zijn gestart of die 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 Enter-PSSession-cmdlet. 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_Sessionsvoor meer informatie over de functie Niet-verbonden sessies.

Deze cmdlet is geïntroduceerd in Windows PowerShell 3.0.

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.

In de uitvoer ziet u dat de opdracht is geslaagd. De status van de sessie wordt Opened en de beschikbaarheids- is Available, wat aangeeft dat u opdrachten in de sessie kunt uitvoeren.

Get-PSSession

Id Name            ComputerName    State         ConfigurationName     Availability
-- ----            ------------    -----         -----------------     ------------
 1 Backups         Localhost       Opened        Microsoft.PowerShell     Available

Get-PSSession | Disconnect-PSSession

Id Name            ComputerName    State         ConfigurationName     Availability
-- ----            ------------    -----         -----------------     ------------
 1 Backups         Localhost       Disconnected  Microsoft.PowerShell          None

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 vervolgens opnieuw verbinding maken met een sessie.

De eerste opdracht maakt gebruik van de Get-PSSession cmdlet. Zonder de parameter ComputerName, krijgt de opdracht alleen sessies die zijn gemaakt in de huidige sessie.

In de uitvoer ziet u dat de opdracht de Backups sessie op de lokale computer ophaalt. De status van de sessie wordt Opened en de Beschikbaarheid is Available.

De tweede opdracht maakt gebruik van de Get-PSSession cmdlet om de PSSession objecten op te halen die zijn gemaakt in de huidige sessie en de Disconnect-PSSession cmdlet om de sessies los te koppelen. In de uitvoer ziet u dat de verbinding met de Backups sessie is verbroken. De status van de sessie wordt Disconnected en de Beschikbaarheid is None.

De derde opdracht maakt gebruik van de Get-PSSession cmdlet om de PSSession objecten op te halen die zijn gemaakt in de huidige sessie en de Connect-PSSession cmdlet om de sessies opnieuw te verbinden. In de uitvoer ziet u dat de Backups sessie opnieuw is verbonden. De status van de sessie wordt Opened en de Beschikbaarheid is Available.

Als u de cmdlet Connect-PSSession gebruikt voor een sessie die niet is losgekoppeld, heeft de opdracht geen invloed op de sessie en worden er geen fouten gegenereerd.

Deze reeks opdrachten laat zien hoe de Connect-PSSession cmdlet kan worden gebruikt in een bedrijfsscenario. 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 deze naar huis. Later die avond meldt de beheerder zich aan bij haar thuiscomputer en controleert of de taak is uitgevoerd totdat deze is voltooid.

De beheerder begint met het maken van sessies op een externe computer en het uitvoeren van een script in de sessie. De eerste opdracht maakt gebruik van de New-PSSession cmdlet om de ITTask sessie op de externe Server01-computer te maken. De opdracht maakt gebruik van de parameter ConfigurationName om de ITTasks sessieconfiguratie op te geven. Met de opdracht worden de sessies opgeslagen in de variabele $s.

De tweede opdracht Invoke-Command cmdlet om een achtergrondtaak te starten in de sessie in de $s variabele. Hierbij wordt de parameter FilePath gebruikt om het script in de achtergrondtaak uit te voeren.

De derde opdracht gebruikt de Disconnect-PSSession cmdlet om de verbinding met de sessie in de $s variabele te verbreken. De opdracht gebruikt de parameter OutputBufferingMode met een waarde van Drop om te voorkomen dat het script wordt geblokkeerd door uitvoer te moeten leveren aan de sessie. Hierbij wordt de parameter IdleTimeoutSec gebruikt om de time-out van de sessie uit te breiden naar 15 uur. Wanneer de opdracht is voltooid, vergrendelt de beheerder haar computer en gaat de avond naar huis.

Later die avond start de beheerder haar thuiscomputer, meldt zich aan bij het bedrijfsnetwerk en start PowerShell. De vierde opdracht maakt gebruik van de Get-PSSession cmdlet om de sessies op de Server01-computer op te halen. Met de opdracht wordt de ITTask sessie gevonden. De vijfde opdracht maakt gebruik van de Connect-PSSession cmdlet om verbinding te maken met de ITTask sessie. Met de opdracht wordt de sessie opgeslagen in de variabele $s.

De zesde opdracht gebruikt de Invoke-Command cmdlet om een Get-Job opdracht uit te voeren in de sessie in de variabele $s. De uitvoer laat zien dat de taak is voltooid. De zevende opdracht maakt gebruik van de Invoke-Command cmdlet om een Receive-Job opdracht uit te voeren in de sessie in de $s variabele in de sessie. Met de opdracht worden de resultaten opgeslagen in de $BackupSpecs variabele. De achtste opdracht maakt gebruik van de Invoke-Command cmdlet om een ander script in de sessie uit te voeren. De opdracht gebruikt de waarde van de $BackupSpecs variabele in de sessie als invoer voor het script.

$s = New-PSSession -ComputerName Server01 -Name ITTask -ConfigurationName ITTasks
Invoke-Command -Session $s -ScriptBlock {Start-Job -FilePath \\Server30\Scripts\Backup-SQLDatabase.ps1}

Id     Name            State         HasMoreData     Location             Command
--     ----            -----         -----------     --------             -------
2      Job2            Running       True            Server01             \\Server30\Scripts\Backup...

Disconnect-PSSession -Session $s -OutputBufferingMode Drop -IdleTimeoutSec 60*60*15

Id Name            ComputerName    State         ConfigurationName     Availability
-- ----            ------------    -----         -----------------     ------------
 1 ITTask          Server01        Disconnected  ITTasks               None

Get-PSSession -ComputerName Server01 -Name ITTask

Id Name            ComputerName    State         ConfigurationName     Availability
-- ----            ------------    -----         -----------------     ------------
 1 ITTask          Server01        Disconnected  ITTasks               None

$s = Connect-PSSession -ComputerName Server01 -Name ITTask

Id Name            ComputerName    State         ConfigurationName     Availability
-- ----            ------------    -----         -----------------     ------------
 1 ITTask          Server01        Opened        ITTasks               Available

Invoke-Command -Session $s -ScriptBlock {Get-Job}

Id     Name            State         HasMoreData     Location             Command
--     ----            -----         -----------     --------             -------
2      Job2            Completed     True            Server01             \\Server30\Scripts\Backup...

Invoke-Command -Session $s -ScriptBlock {$BackupSpecs = Receive-Job -JobName Job2}
Invoke-Command -Session $s -ScriptBlock {\\Server30\Scripts\New-SQLDatabase.ps1 -InitData $BackupSpecs.Initialization}
Disconnect-PSSession -Session $s -OutputBufferingMode Drop -IdleTimeoutSec 60*60*15

Id Name            ComputerName    State         ConfigurationName     Availability
-- ----            ------------    -----         -----------------     ------------
 1 ITTask          Server01        Disconnected  ITTasks               None

De negende opdracht verbreekt de verbinding met de sessie in de variabele $s. De beheerder sluit PowerShell en sluit de computer. Ze kan de volgende dag opnieuw verbinding maken met de sessie en de scriptstatus controleren vanaf haar werkcomputer.

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

U kunt een sessie (PSSession) doorsluizen naar deze cmdlet.

Met deze cmdlet wordt een object geretourneerd dat de sessie vertegenwoordigt waarmee deze opnieuw verbinding heeft gemaakt.

PowerShell bevat de volgende aliassen voor Connect-PSSession:

• Windows:

  • cnsn

• Deze cmdlet is alleen beschikbaar op Windows-platforms.

• Connect-PSSession alleen opnieuw verbinding maakt met sessies die niet zijn verbonden, dat wil gezegd, sessies met de waarde Verbinding verbroken voor de eigenschap Status. Alleen sessies die zijn verbonden met of eindigen op computers met Windows PowerShell 3.0 of hoger, kunnen worden verbroken en opnieuw worden verbonden.

• Als u Connect-PSSession gebruikt voor een sessie die niet is losgekoppeld, heeft de opdracht geen invloed op de sessie en worden er geen fouten gegenereerd.

• Verbroken 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 beveiligt de computer tegen schadelijke toegang.

• 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. Gebruik de eigenschap Availability om te bepalen of u verbinding kunt maken met de sessie of opnieuw verbinding kunt maken met de sessie.

  Een beschikbaarheidswaarde van Geen 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-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.

• U kunt de time-outwaarde voor inactiviteit van een PSSession- niet wijzigen wanneer u verbinding maakt met de PSSession-. De SessionOption-parameter van Connect-PSSession accepteert een SessionOption--object dat een IdleTimeout--waarde heeft. De IdleTimeout- waarde van het object SessionOption en de IdleTimeout- waarde 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 New-PSSession- of Invoke-Command-cmdlets en wanneer u de verbinding met de PSSession-verbreekt.

  De eigenschap IdleTimeout van een PSSession- is essentieel voor verbroken sessies, omdat hiermee wordt bepaald 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 is verbroken, zelfs als opdrachten worden uitgevoerd in de niet-verbonden sessie.