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

Этот командлет доступен только на платформе Windows.

Командлет Connect-PSSession повторно подключается к сеансам PowerShell, управляемым пользователем (PSSessions), которые были отключены. Он работает на сеансах, которые намеренно отключены, например с помощью Disconnect-PSSession командлета или параметра Invoke-CommandInDisconnectedSession командлета, и тех, которые были отключены непреднамеренно, например временным сбоем сети.

Connect-PSSession может подключиться к любому отключенному сеансу, запущенному тем же пользователем. К ним относятся те, которые были запущены или отключены от других сеансов на других компьютерах.

Connect-PSSession Однако не удается подключиться к неработаемым или закрытым сеансам или интерактивным сеансам, запущенным с помощью командлетаEnter-PSSession. Кроме того, нельзя подключать сеансы к сеансам, запущенным другими пользователями, если только вы не можете предоставить учетные данные пользователя, создавшего сеанс.

Дополнительные сведения о функции разъединённых сеансов см. в разделе about_Remote_Disconnected_Sessions.

Этот командлет был введён в Windows PowerShell 3.0.

Connect-PSSession -ComputerName Server01 -Name ITTask

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

Эта команда повторно подключается к ITTask сеансу на компьютере Server01.

В выходных данных показано, что команда выполнена успешно. Состояние сеанса и OpenedдоступностьAvailable, указывающая, что можно выполнять команды в сеансе.

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

В этом примере показан эффект отключения и повторного подключения к сеансу.

Первая команда использует Get-PSSession командлет. Без параметра ComputerName команда получает только сеансы, созданные в текущем сеансе.

Выходные данные показывают, что команда получает Backups сеанс на локальном компьютере. Состояние сеанса и OpenedдоступностьAvailable.

Вторая команда использует Get-PSSession командлет для получения объектов PSSession , созданных в текущем сеансе, и Disconnect-PSSession командлета для отключения сеансов. Выходные данные показывают, что Backups сеанс был отключен. Состояние сеанса и DisconnectedдоступностьNone.

Третья команда использует Get-PSSession командлет для получения объектов PSSession , созданных в текущем сеансе, и Connect-PSSession командлета для повторного подключения сеансов. Выходные данные показывают, что Backups сеанс был повторно подключен. Состояние сеанса и OpenedдоступностьAvailable.

Если вы используете Connect-PSSession командлет для сеанса, который не отключен, команда не влияет на сеанс и не создает никаких ошибок.

В этой серии команд показано, как командлет Connect-PSSession может использоваться в корпоративном сценарии. В этом случае системный администратор запускает длительное задание в сеансе на удаленном компьютере. После запуска задания администратор отключается от сеанса и отправляется домой. Позже вечером администратор входит на свой домашний компьютер и проверяет, запущен ли задание до завершения работы.

Администратор начинает создание сеансов на удаленном компьютере и выполнение скрипта в сеансе. Первая команда использует New-PSSession командлет для создания сеанса ITTask на удаленном компьютере Server01. Команда использует параметр ConfigurationName для указания конфигурации сеанса ITTasks . Команда сохраняет сеансы в переменной $s.

Второй командлет команды Invoke-Command для запуска фонового задания в сеансе в переменной $s . Он использует параметр FilePath для запуска скрипта в фоновом задании.

Третья команда использует Disconnect-PSSession командлет для отключения от сеанса в переменной $s . Команда использует параметр OutputBufferingMode со значением Drop , чтобы предотвратить блокировку скрипта путем доставки выходных данных в сеанс. Он использует параметр IdleTimeoutSec для расширения времени ожидания сеанса до 15 часов. После завершения команды администратор блокирует компьютер и отправляется домой на вечер.

Позже вечером администратор запускает свой домашний компьютер, входит в корпоративную сеть и запускает PowerShell. Четвертая команда использует Get-PSSession командлет для получения сеансов на компьютере Server01. Команда находит ITTask сеанс. Пятая команда использует Connect-PSSession командлет для подключения к сеансу ITTask . Команда сохраняет сеанс в переменной $s.

Шестая команда использует Invoke-Command командлет для выполнения Get-Job команды в сеансе в переменной $s . В выходных данных показано, что задание успешно завершено. Седьмая команда использует Invoke-Command командлет для выполнения Receive-Job команды в сеансе в переменной $s в сеансе. Команда сохраняет результаты в переменной $BackupSpecs . Восьмая команда использует Invoke-Command командлет для запуска другого скрипта в сеансе. Команда использует значение переменной $BackupSpecs в сеансе в качестве входных данных для скрипта.

$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

Девятая команда отключается от сеанса в переменной $s . Администратор закрывает PowerShell и закрывает компьютер. Она может снова подключиться к сеансу на следующий день и проверить состояние скрипта с рабочего компьютера.

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Вы можете передать сеанс (PSSession) в этот командлет.

Этот командлет возвращает объект, представляющий сеанс, к которому он повторно подключен.

PowerShell включает следующие псевдонимы для Connect-PSSession:

• Виндоус:

  • cnsn

• Этот командлет доступен только на платформах Windows.

• Connect-PSSession повторно подключается только к сеансам, которые отключены, то есть сеансы, имеющие значение "Отсоединяемый" для свойства State . Можно отключить и повторно подключить только сеансы, подключенные к компьютерам под управлением Windows PowerShell 3.0 или более поздних версий.

• Если вы используете Connect-PSSession сеанс, который не отключен, команда не влияет на сеанс и не создает ошибок.

• Отключенные сеансы обратного цикла с интерактивными токенами, созданными с помощью параметра EnableNetworkAccess, можно повторно подключить только с компьютера, на котором был создан сеанс. Это ограничение защищает компьютер от вредоносного доступа.

• Значение свойства состояния PSSess ion относительно текущего сеанса. Таким образом, значение отключенных означает, что PSSession не подключен к текущему сеансу. Однако это не означает, что PSSession отключен от всех сеансов. Он может быть подключен к другому сеансу. Чтобы определить, можно ли подключиться или повторно подключиться к сеансу, используйте свойство доступности.

  Значение доступности "None" указывает, что вы можете подключиться к сеансу. Значение "Занято" указывает, что подключение к PSSession невозможно, так как оно подключено к другому сеансу.

  Дополнительные сведения о значениях свойства состояния сеансов см. вперечисления RunspaceState.

  Дополнительные сведения о значениях свойства доступности сеансов см. в перечисления RunspaceAvailability.

• Невозможно изменить значение времени ожидания простоя PSSession при подключении к PSSession. Параметр SessionOptionConnect-PSSession принимает объект SessionOption, имеющий значение IdleTimeout. Однако значение IdleTimeout объекта SessionOption и значение IdleTimeout переменной $PSSessionOption игнорируются при подключении к PSSession.

  Вы можете задать и изменить время ожидания PSSession при создании PSSessionс помощью командлетов New-PSSession или Invoke-Command, а также при отключении от PSSession.

  Свойство IdleTimeout PSSession имеет решающее значение для отключенных сеансов, так как определяет, сколько времени сеанс отключен на удаленном компьютере сохраняется. Отключенные сеансы считаются неактивными с момента отключения, даже если команды выполняются в отключенном сеансе.