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>]

El cmdlet Connect-PSSession se vuelve a conectar a las sesiones de Windows PowerShell administradas por el usuario (PSSessions) que se desconectaron. Funciona en sesiones que se desconectan intencionadamente, como mediante el cmdlet Disconnect-PSSession o el InDisconnectedSession parámetro del cmdlet Invoke-Command y los que se desconectaron involuntariamente, como por una interrupción temporal de la red.

Connect-PSSession puede conectarse a cualquier sesión desconectada que haya sido iniciada por el mismo usuario. Entre ellas se incluyen las iniciadas por o desconectadas de otras sesiones en otros equipos.

Sin embargo, connect-PSSession no se puede conectar a sesiones interrumpidas o cerradas, ni a sesiones interactivas iniciadas mediante el cmdlet Enter-PSSession. Tampoco puede conectar sesiones a sesiones iniciadas por otros usuarios, a menos que pueda proporcionar las credenciales del usuario que creó la sesión.

Para obtener más información sobre la característica Sesiones desconectadas, consulte about_Remote_Disconnected_Sessions.

Este cmdlet se introdujo en Windows PowerShell 3.0.

PS C:\> Connect-PSSession -ComputerName Server01 -Name ITTask
Id Name            ComputerName    State         ConfigurationName     Availability
-- ----            ------------    -----         -----------------     ------------
 4 ITTask          Server01        Opened        ITTasks                  Available

Este comando se vuelve a conectar a la sesión de ITTask en el equipo Server01.

La salida muestra que el comando se realizó correctamente. El estado de la sesión es Abierto y la disponibilidad es Disponible, lo que indica que puede ejecutar comandos en la sesión.

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

En este ejemplo se muestra el efecto de desconectar y, a continuación, volver a conectarse a una sesión.

El primer comando usa el cmdlet Get-PSSession. Sin el parámetro ComputerName, el comando obtiene solo las sesiones que se crearon en la sesión actual.

La salida muestra que el comando obtiene la sesión copias de seguridad en el equipo local. El estado de la sesión es Abierto y la Disponibilidad es Disponible.

El segundo comando usa el cmdlet Get-PSSession para obtener los objetos PSSession que se crearon en la sesión actual y el cmdlet Disconnect-PSSession para desconectar las sesiones. La salida muestra que se desconectó la sesión de copias de seguridad. El estado de la sesión es Desconectado y la disponibilidad es Ninguno .

El tercer comando usa el cmdlet Get-PSSession para obtener los objetos PSSession que se crearon en la sesión actual y el cmdlet Connect-PSSession para volver a conectar las sesiones. La salida muestra que se ha vuelto a conectar la sesión de copias de seguridad. El estado de la sesión es Abierto y la Disponibilidad es Disponible.

Si usa el cmdlet Connect-PSSession en una sesión que no está desconectada, el comando no afecta a la sesión y no genera ningún error.

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

Esta serie de comandos muestra cómo se puede usar el cmdlet Connect-PSSession en un escenario empresarial. En este caso, un administrador del sistema inicia un trabajo de ejecución prolongada en una sesión en un equipo remoto. Después de iniciar el trabajo, el administrador se desconecta de la sesión y se vuelve a casa. Más tarde, el administrador inicia sesión en su equipo doméstico y comprueba que el trabajo se ejecutó hasta que se complete.

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Puede canalizar una sesión (PSSession) a este cmdlet.

Este cmdlet devuelve un objeto que representa la sesión a la que se volvió a conectar.

• Connect-PSSession se vuelve a conectar solo a las sesiones que están desconectadas, es decir, las sesiones que tienen un valor de Disconnected para la propiedad State . Solo las sesiones conectadas a equipos que ejecutan Windows PowerShell 3.0 o versiones posteriores solo se pueden desconectar y volver a conectar.

• Si utiliza Connect-PSSession en una sesión que no está desconectada, el comando no afecta a la sesión y no genera errores.

• Las sesiones de bucle invertido desconectadas con tokens interactivos, que se crean mediante el parámetro EnableNetworkAccess, solo se pueden volver a conectar desde el equipo en el que se creó la sesión. Esta restricción protege el equipo contra el acceso malintencionado.

• El valor de la propiedad state de un PSSession de es relativo a la sesión actual. Por lo tanto, un valor de Desconectado significa que el de PSSession de no está conectado a la sesión actual. Sin embargo, no significa que el psSession se desconecta de todas las sesiones. Puede estar conectado a otra sesión. Para determinar si puede conectarse o reconectarse a la sesión, utilice la propiedad Disponibilidad.

  Un valor de Disponibilidad de Ninguno indica que puede conectarse a la sesión. Un valor de Busy indica que no se puede conectar al de PSSession de porque está conectado a otra sesión.

  Para obtener más información sobre los valores de la propiedad state de de sesiones, vea RunspaceState Enumeration en MSDN Library.

  Para obtener más información sobre los valores de la propiedad availability de sesiones, vea RunspaceAvailability Enumeration en MSDN Library.

• No se puede cambiar el valor de tiempo de espera de inactividad de un psSession de cuando se conecta al psSession de. El parámetro SessionOption de Connect-PSSession toma un objeto sessionOption que tiene un valor IdleTimeout. Sin embargo, el valor IdleTimeout del objeto SessionOption y el valor IdleTimeout de la variable $PSSessionOption se omiten al conectarse a un PSSession.

  Puede establecer y cambiar el tiempo de espera de inactividad de una PSSession al crear la PSSession, mediante los cmdlets New-PSSession o Invoke-Command , y cuando se desconecte de la PSSession.

  La propiedad IdleTimeout de un PSSession es fundamental para las sesiones desconectadas, ya que determina cuánto tiempo se mantiene una sesión desconectada en el equipo remoto. Las sesiones desconectadas se consideran inactivas desde el momento en que se desconectan, incluso si los comandos se ejecutan en la sesión desconectada.