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

Ten cmdlet jest dostępny tylko na platformie Windows.

Polecenie Connect-PSSession cmdlet ponownie łączy się z sesjami programu PowerShell zarządzanymi przez użytkownika (PSSessions), które zostały rozłączone. Działa on w przypadku sesji, które są rozłączane celowo, na przykład za pomocą Disconnect-PSSession polecenia cmdlet lub parametruInvoke-Command InDisconnectedSession polecenia cmdlet, a te, które zostały rozłączone przypadkowo, takie jak tymczasowa awaria sieci.

Connect-PSSession program może nawiązać połączenie z dowolną odłączona sesją, która została uruchomiona przez tego samego użytkownika. Należą do nich te, które zostały uruchomione lub odłączone od innych sesji na innych komputerach.

Connect-PSSession Nie można jednak nawiązać połączenia z przerwaną lub zamkniętą sesją albo sesjami interaktywnymi uruchomionymi przy użyciu Enter-PSSession polecenia cmdlet . Ponadto nie można połączyć sesji z sesjami uruchomionymi przez innych użytkowników, chyba że można podać poświadczenia użytkownika, który utworzył sesję.

Aby uzyskać więcej informacji na temat funkcji rozłączonych sesji, zobacz about_Remote_Disconnected_Sessions.

To cmdlet zostało wprowadzone w Windows PowerShell 3.0.

Connect-PSSession -ComputerName Server01 -Name ITTask

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

To polecenie ponownie łączy się z sesją ITTask na komputerze Server01.

Dane wyjściowe pokazują, że polecenie zakończyło się pomyślnie. Stan sesji to Opened i dostępność to Available, co wskazuje, że można uruchamiać polecenia w sesji.

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

W tym przykładzie pokazano efekt rozłączania, a następnie ponownego nawiązywania połączenia z sesją.

Pierwsze polecenie używa Get-PSSession polecenia cmdlet . Bez parametru ComputerName polecenie pobiera tylko sesje utworzone w bieżącej sesji.

Dane wyjściowe pokazują, że polecenie pobiera sesję Backups na komputerze lokalnym. Stan sesji to Opened , a dostępność to Available.

Drugie polecenie używa Get-PSSession polecenia cmdlet do pobrania obiektów PSSession utworzonych w bieżącej sesji i Disconnect-PSSession polecenia cmdlet w celu rozłączenia sesji. Dane wyjściowe pokazują, że sesja Backups została rozłączona. Stan sesji to Disconnected , a dostępność to None.

Trzecie polecenie używa Get-PSSession polecenia cmdlet do pobrania obiektów PSSession utworzonych w bieżącej sesji i Connect-PSSession polecenia cmdlet w celu ponownego połączenia sesji. Dane wyjściowe pokazują, że sesja Backups została ponownie połączona. Stan sesji to Opened , a dostępność to Available.

Jeśli używasz Connect-PSSession polecenia cmdlet w sesji, która nie jest rozłączona, polecenie nie ma wpływu na sesję i nie generuje żadnych błędów.

W tej serii poleceń pokazano, jak polecenie cmdlet Connect-PSSession może być używane w scenariuszu przedsiębiorstwa. W takim przypadku administrator systemu uruchamia długotrwałe zadanie w sesji na komputerze zdalnym. Po uruchomieniu zadania administrator rozłącza się z sesją i wraca do domu. Później tego wieczoru administrator loguje się do komputera macierzystego i sprawdza, czy zadanie zostało uruchomione do momentu jego ukończenia.

Administrator rozpoczyna się od utworzenia sesji na komputerze zdalnym i uruchomienia skryptu w sesji. Pierwsze polecenie używa New-PSSession polecenia cmdlet do utworzenia ITTask sesji na komputerze zdalnym Server01. Polecenie używa parametru ConfigurationName do określenia ITTasks konfiguracji sesji. Polecenie zapisuje sesje w zmiennej $s.

Drugie polecenie cmdlet, Invoke-Command aby uruchomić zadanie w tle w sesji w zmiennej $s . Używa parametru FilePath do uruchomienia skryptu w zadaniu w tle.

Trzecie polecenie używa Disconnect-PSSession polecenia cmdlet , aby odłączyć się od sesji w zmiennej $s . Polecenie używa parametru OutputBufferingMode z wartością Drop , aby zapobiec zablokowaniu skryptu przez konieczność dostarczania danych wyjściowych do sesji. Używa parametru IdleTimeoutSec , aby przedłużyć limit czasu sesji do 15 godzin. Po zakończeniu polecenia administrator blokuje komputer i wraca do domu na wieczór.

Później tego wieczoru administrator uruchamia swój komputer domowy, loguje się do sieci firmowej i uruchamia program PowerShell. Czwarte polecenie używa Get-PSSession polecenia cmdlet do pobrania sesji na komputerze Server01. Polecenie znajduje sesję ITTask . Piąte polecenie używa Connect-PSSession polecenia cmdlet do nawiązania połączenia z sesją ITTask . Polecenie zapisuje sesję w zmiennej $s.

Szóste polecenie używa Invoke-Command polecenia cmdlet do uruchomienia Get-Job polecenia w sesji w zmiennej $s . Dane wyjściowe pokazują, że zadanie zostało ukończone pomyślnie. Siódme polecenie używa Invoke-Command polecenia cmdlet do uruchomienia Receive-Job polecenia w sesji w zmiennej $s w sesji. Polecenie zapisuje wyniki w zmiennej $BackupSpecs . Ósme polecenie używa Invoke-Command polecenia cmdlet do uruchamiania innego skryptu w sesji. Polecenie używa wartości $BackupSpecs zmiennej w sesji jako danych wejściowych skryptu.

$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

Dziewiąte polecenie rozłącza się z sesją w zmiennej $s . Administrator zamyka program PowerShell i zamyka komputer. Następnego dnia może ponownie nawiązać połączenie z sesją i sprawdzić stan skryptu z komputera służbowego.

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Do tego polecenia cmdlet można przekazać potok sesji (PSSession).

To polecenie cmdlet zwraca obiekt reprezentujący sesję, z którą ponownie nawiązano połączenie.

Program PowerShell zawiera następujące aliasy dla Connect-PSSession:

• Windows:

  • cnsn

• Ten cmdlet jest dostępny tylko na platformach Windows.

• Connect-PSSession Ponownie łączy się tylko z sesjami, które są rozłączone, czyli sesje, które mają wartość Rozłączone dla właściwości State . Tylko sesje połączone z komputerami z programem Windows PowerShell 3.0 lub nowszym można odłączyć i ponownie nawiązać połączenie.

• Jeśli używasz Connect-PSSession w sesji, która nie jest rozłączona, polecenie nie ma wpływu na sesję i nie generuje błędów.

• Rozłączone sesje sprzężenia zwrotnego z tokenami interaktywnymi, które są tworzone przy użyciu parametru EnableNetworkAccess, można ponownie połączyć tylko z komputera, na którym została utworzona sesja. To ograniczenie chroni komputer przed złośliwym dostępem.

• Wartość właściwości stanu jest względna dla bieżącej sesji. W związku z tym wartość Rozłączone oznacza, że PSSession nie jest połączona z bieżącą sesją. Nie oznacza to jednak, że PSSession jest odłączony od wszystkich sesji. Może być połączony z inną sesją. Aby określić, czy można nawiązać połączenie z sesją, czy ponownie nawiązać połączenie, użyj właściwości Availability.

  Wartość Dostępności Brak wskazuje, że można nawiązać połączenie z sesją. Wartość Busy wskazuje, że nie można nawiązać połączenia z PSSession, ponieważ jest połączony z inną sesją.

  Aby uzyskać więcej informacji na temat wartości właściwości stanu sesji, zobacz RunspaceState, wyliczenie.

  Aby uzyskać więcej informacji na temat wartości właściwości dostępności sesji, zobacz RunspaceAvailability Enumeration.

• Nie można zmienić wartości limitu czasu bezczynności PSSession podczas nawiązywania połączenia z pssession. Parametr SessionOptionConnect-PSSession przyjmuje obiekt SessionOption, który ma wartość IdleTimeout. Jednak wartość IdleTimeout obiektu SessionOption i wartość $PSSessionOptionIdleTimeout zmiennej są ignorowane podczas nawiązywania połączenia z usługą PSSession.

  Możesz ustawić i zmienić limit czasu bezczynności PSSession podczas tworzenia PSSession, przy użyciu poleceń cmdlet New-PSSession lub Invoke-Command, oraz podczas rozłączania się z PSSession.

  Właściwość IdleTimeout pssession ma kluczowe znaczenie dla rozłączonych sesji, ponieważ określa, jak długo jest utrzymywana rozłączona sesja na komputerze zdalnym. Odłączone sesje są uważane za bezczynne od momentu ich rozłączenia, nawet jeśli polecenia są uruchomione w sesji rozłączonej.