Connect-PSSession

구문

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

Connect-PSSession cmdlet은 연결이 끊긴 사용자 관리 Windows PowerShell 세션(PSSessions)에 다시 연결됩니다. Disconnect-PSSession cmdlet 또는 Invoke-Command cmdlet의 InDisconnectedSession 매개 변수를 사용하고 임시 네트워크 중단과 같이 의도치 않게 연결이 끊어진 세션과 같이 의도적으로 연결이 끊긴 세션에서 작동합니다.

Connect-PSSession 동일한 사용자가 시작한 연결이 끊긴 세션에 연결할 수 있습니다. 여기에는 다른 컴퓨터의 다른 세션에서 시작하거나 연결이 끊긴 세션이 포함됩니다.

그러나 Connect-PSSession 중단되거나 닫힌 세션 또는 Enter-PSSession cmdlet을 사용하여 시작된 대화형 세션에 연결할 수 없습니다. 또한 세션을 만든 사용자의 자격 증명을 제공할 수 없다면 다른 사용자가 시작한 세션에 세션을 연결할 수 없습니다.

연결이 끊긴 세션 기능에 대한 자세한 내용은 about_Remote_Disconnected_Sessions 참조하세요.

이 cmdlet은 Windows PowerShell 3.0에서 도입되었습니다.

예제

예제 1: 세션에 다시 연결

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

이 명령은 Server01 컴퓨터의 ITTask 세션에 다시 연결됩니다.

출력은 명령이 성공했음을 보여줍니다. 세션의 상태 열리고 가용성 사용할 수 있습니다. 이는 세션에서 명령을 실행할 수 있음을 나타냅니다.

예제 2: 연결 끊기 및 다시 연결의 효과

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

이 예제에서는 세션의 연결을 끊은 다음 다시 연결하는 효과를 보여 냅니다.

첫 번째 명령은 Get-PSSession cmdlet을 사용합니다. ComputerName 매개 변수가 없으면 명령은 현재 세션에서 만든 세션만 가져옵니다.

출력은 명령이 로컬 컴퓨터에서 Backups 세션을 가져오는 것을 보여 줍니다. 세션의 상태 열리고 가용성 사용할 수 있습니다.

두 번째 명령은 Get-PSSession cmdlet을 사용하여 현재 세션에서 만든 PSSession 개체와 Disconnect-PSSession cmdlet을 사용하여 세션 연결을 끊습니다. 출력은 Backups 세션의 연결이 끊어진 것을 보여 줍니다. 세션의 상태 연결이 끊어지고 가용성 없음입니다.

세 번째 명령은 Get-PSSession cmdlet을 사용하여 현재 세션에서 만든 PSSession 개체와 Connect-PSSession cmdlet을 가져와 세션을 다시 연결합니다. 출력은 Backups 세션이 다시 연결되었음을 보여 줍니다. 세션의 상태 열리고 가용성 사용할 수 있습니다.

연결이 끊어지지 않은 세션에서 Connect-PSSession cmdlet을 사용하는 경우 명령은 세션에 영향을 주지 않으며 오류를 생성하지 않습니다.

예제 3: 엔터프라이즈 시나리오의 일련의 명령

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

이 일련의 명령은 엔터프라이즈 시나리오에서 Connect-PSSession cmdlet을 사용하는 방법을 보여 줍니다. 이 경우 시스템 관리자는 원격 컴퓨터의 세션에서 장기 실행 작업을 시작합니다. 작업을 시작한 후 관리자는 세션에서 연결을 끊고 집으로 돌아갑니다. 그날 저녁, 관리자는 홈 컴퓨터에 로그온하여 작업이 완료될 때까지 실행되었는지 확인합니다.

매개 변수

-AllowRedirection

-ApplicationName

-Authentication

-CertificateThumbprint

-ComputerName

-ConfigurationName

-Confirm

-ConnectionUri

-Credential

-Id

-InstanceId

-Name

-Port

-Session

-SessionOption

-ThrottleLimit

-UseSSL

-WhatIf

입력

PSSession

세션(PSSession)을 이 cmdlet으로 파이프할 수 있습니다.

출력

PSSession

이 cmdlet은 다시 연결한 세션을 나타내는 개체를 반환합니다.

참고

• Connect-PSSession 연결이 끊어진 세션, 즉 State 속성에 대해 Disconnected 값이 있는 세션에만 다시 연결됩니다. Windows PowerShell 3.0 이상 버전을 실행하는 컴퓨터에 연결되거나 종료되는 세션만 연결을 끊고 다시 연결할 수 있습니다.

• 연결이 끊어지지 않은 세션에서 Connect-PSSession 사용하는 경우 명령은 세션에 영향을 주지 않으며 오류를 생성하지 않습니다.

• EnableNetworkAccess 매개 변수를 사용하여 만든 대화형 토큰이 있는 연결이 끊긴 루프백 세션은 세션이 만들어진 컴퓨터에서만 다시 연결할 수 있습니다. 이 제한은 악의적인 액세스로부터 컴퓨터를 보호합니다.

• PSSessionState 속성 값은 현재 세션을 기준으로 합니다. 따라서 연결 끊김 값은 PSSession 현재 세션에 연결되지 않음을 의미합니다. 그러나 PSSession 모든 세션에서 연결이 끊어진 것은 아닙니다. 다른 세션에 연결될 수 있습니다. 세션에 연결하거나 다시 연결할 수 있는지 여부를 확인하려면 가용성 속성을 사용합니다.

  가용성 값은 세션에 연결할 수 있음을 나타냅니다. 사용 중 값은 다른 세션에 연결되어 있으므로 PSSession 연결할 수 없음을 나타냅니다.

  세션의 State 속성 값에 대한 자세한 내용은 MSDN 라이브러리의 RunspaceState 열거형 참조하세요.

  세션의 가용성 속성 값에 대한 자세한 내용은 MSDN 라이브러리의 RunspaceAvailability 열거형 참조하세요.

• PSSession연결할 때는 PSSession 유휴 시간 제한 값을 변경할 수 없습니다. Connect-PSSessionSessionOption 매개 변수는 IdleTimeout 값이 있는 SessionOption 개체를 사용합니다. 그러나 SessionOption 개체의 IdleTimeout 값과 $PSSessionOption 변수의 IdleTimeout 값은 PSSession연결할 때 무시됩니다.

  New-PSSession 또는 Invoke-Command cmdlet을 사용하고 PSSession연결을 끊으면 PSSession만들 때 PSSession 유휴 시간 제한 시간을 설정하고 변경할 수 있습니다.

  PSSessionIdleTimeout 속성은 연결이 끊긴 세션이 원격 컴퓨터에서 유지 관리되는 기간을 결정하기 때문에 연결이 끊긴 세션에 중요합니다. 연결이 끊긴 세션은 연결이 끊긴 세션에서 명령이 실행되는 경우에도 연결이 끊긴 순간부터 유휴 상태로 간주됩니다.

관련 링크

• 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