Connect-PSSession

Syntaxe

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

Tato rutina je dostupná jenom na platformě Windows.

Rutina Connect-PSSession se znovu připojí k relacím PowerShellu spravovaným uživatelem (PSSessions), které byly odpojeny. Funguje na relacích, které jsou záměrně odpojené, například pomocí Disconnect-PSSession rutiny nebo parametru Invoke-Command InDisconnectedSession rutiny a těch, které byly neúmyslně odpojeny, například dočasným výpadkem sítě.

Connect-PSSession se může připojit k jakékoli odpojené relaci, kterou spustil stejný uživatel. Patří sem ty, které byly spuštěny nebo odpojeny od jiných relací v jiných počítačích.

Connect-PSSession Nelze se ale připojit k přerušeným nebo uzavřeným relacím nebo interaktivním relacím, které se spustily pomocí rutinyEnter-PSSession. Relace spuštěné jinými uživateli se také nedají připojit k relacím, pokud nemůžete zadat přihlašovací údaje uživatele, který relaci vytvořil.

Další informace o funkci Odpojené relace najdete v tématu about_Remote_Disconnected_Sessions.

Tato rutina byla zavedena ve Windows PowerShellu 3.0.

Příklady

Příklad 1: Opětovné připojení k relaci

Connect-PSSession -ComputerName Server01 -Name ITTask

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

Tento příkaz se znovu připojí k ITTask relaci na počítači Serveru01.

Výstup ukazuje, že příkaz byl úspěšný. Stav relace je a dostupnost je Opened Available, což značí, že v relaci můžete spouštět příkazy.

Příklad 2: Účinek odpojení a opětovného připojení

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

Tento příklad ukazuje účinek odpojení a opětovného připojení k relaci.

První příkaz používá rutinu Get-PSSession . Bez parametru ComputerName získá příkaz pouze relace vytvořené v aktuální relaci.

Výstup ukazuje, že příkaz získá Backups relaci na místním počítači. Stav relace je Opened a dostupnost je Available.

Druhý příkaz pomocí rutiny Get-PSSession získá objekty PSSession , které byly vytvořeny v aktuální relaci, a rutina Disconnect-PSSession k odpojení relací. Výstup ukazuje, že Backups relace byla odpojena. Stav relace je Disconnected a dostupnost je None.

Třetí příkaz používá rutinu Get-PSSession k získání objektů PSSession vytvořených v aktuální relaci a rutiny Connect-PSSession k opětovnému připojení relací. Výstup ukazuje, že Backups se relace znovu připojila. Stav relace je Opened a dostupnost je Available.

Pokud použijete rutinu Connect-PSSession v relaci, která není odpojená, příkaz neovlivní relaci a nevygeneruje žádné chyby.

Příklad 3: Řada příkazů v podnikovém scénáři

Tato série příkazů ukazuje, jak se rutina Connect-PSSession může používat v podnikovém scénáři. V takovém případě správce systému spustí dlouho běžící úlohu v relaci na vzdáleném počítači. Po spuštění úlohy se správce odpojí od relace a přejde domů. Později se správce přihlásí ke svému domovskému počítači a ověří, že úloha běžela, dokud se nedokončí.

Správce začne vytvořením relací na vzdáleném počítači a spuštěním skriptu v relaci. První příkaz pomocí rutiny New-PSSession vytvoří ITTask relaci na vzdáleném počítači Serveru01. Příkaz k zadání ITTasks konfigurace relace používá parametr ConfigurationName. Příkaz uloží relace do $s proměnné.

Druhá rutina příkazu Invoke-Command , která spustí úlohu na pozadí v relaci v $s proměnné. Používá parametr FilePath ke spuštění skriptu v úloze na pozadí.

Třetí příkaz používá rutinu Disconnect-PSSession k odpojení od relace v $s proměnné. Příkaz používá parametr OutputBufferingMode s hodnotou, která Drop brání zablokování skriptu tím, že musí do relace doručovat výstup. Používá parametr IdleTimeoutSec k prodloužení časového limitu relace na 15 hodin. Po dokončení příkazu správce uzamkne svůj počítač a večer přejde domů.

Později večer správce spustí svůj domácí počítač, přihlásí se k podnikové síti a spustí PowerShell. Čtvrtý příkaz používá rutinu Get-PSSession k získání relací na počítači Server01. Příkaz najde ITTask relaci. Pátý příkaz používá rutinu Connect-PSSession pro připojení k ITTask relaci. Příkaz uloží relaci do $s proměnné.

Šestý příkaz používá rutinu Invoke-Command Get-Job ke spuštění příkazu v relaci v $s proměnné. Výstup ukazuje, že úloha byla úspěšně dokončena. Sedmý příkaz používá rutinu Invoke-Command Receive-Job ke spuštění příkazu v relaci v $s proměnné v relaci. Příkaz uloží výsledky do $BackupSpecs proměnné. Osmý příkaz používá rutinu Invoke-Command ke spuštění dalšího skriptu v relaci. Příkaz používá hodnotu $BackupSpecs proměnné v relaci jako vstup do skriptu.

$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

Devátý příkaz se odpojí od relace v $s proměnné. Správce zavře PowerShell a počítač zavře. Může se k relaci připojit znovu následující den a zkontrolovat stav skriptu ze svého pracovního počítače.

Parametry

-AllowRedirection

-ApplicationName

-Authentication

-CertificateThumbprint

-ComputerName

-ConfigurationName

-Confirm

-ConnectionUri

-Credential

-Id

-InstanceId

-Name

-Port

-Session

-SessionOption

-ThrottleLimit

-UseSSL

-WhatIf

Vstupy

PSSession

K této rutině můžete převést relaci (PSSession).

Výstupy

PSSession

Tato rutina vrátí objekt, který představuje relaci, ke které se znovu připojila.

Poznámky

PowerShell obsahuje následující aliasy pro Connect-PSSession:

• Windows:

  • cnsn

• Tato rutina je dostupná jenom na platformách Windows.

• Connect-PSSession reconnects only to sessions that are disconnected, that is, sessions that have a value Of Disconnected for the State vlastnost. Je možné odpojit a znovu připojit pouze relace připojené k počítačům, na kterých běží Windows PowerShell 3.0 nebo novější verze.

• Pokud používáte Connect-PSSession relaci, která není odpojena, příkaz nemá vliv na relaci a negeneruje chyby.

• Odpojené relace zpětné smyčky s interaktivními tokeny, které jsou vytvořeny pomocí parametru EnableNetworkAccess , je možné znovu připojit pouze z počítače, na kterém byla relace vytvořena. Toto omezení chrání počítač před škodlivým přístupem.

• Hodnota State vlastnost PSSession je relativní k aktuální relaci. Proto hodnota Odpojeno znamená, že psSession není připojen k aktuální relaci. Neznamená ale, že psSession je odpojen od všech relací. Může se připojit k jiné relaci. Chcete-li zjistit, zda se můžete připojit nebo znovu připojit k relaci, použijte vlastnost Dostupnost .

  Hodnota Dostupnost none označuje, že se můžete připojit k relaci. Hodnota Zaneprázdněn označuje, že se nemůžete připojit k psSession , protože je připojen k jiné relaci.

  Další informace o hodnotách State vlastnost relací naleznete v tématu RunspaceState Výčtu.

  Další informace o hodnotách vlastnosti Availability relací naleznete v tématu RunspaceAvailability Výčet.

• Při připojování k psSession nelze změnit hodnotu časového limitu nečinnosti psSession. Parametr SessionOption Connect-PSSession přebírá SessionOption objekt, který má hodnotu IdleTimeout . Hodnota IdleTimeout objektu SessionOption a hodnota $PSSessionOption IdleTimeout proměnné jsou však ignorovány při připojování k PSSession.

  Při vytváření psSession můžete nastavit a změnit časový limit nečinnosti při vytváření psSession, pomocí New-PSSession rutin nebo Invoke-Command rutin a při odpojení od psSession.

  Vlastnost IdleTimeout relace PSSession je důležitá pro odpojené relace, protože určuje, jak dlouho se odpojená relace udržuje ve vzdáleném počítači. Odpojené relace se považují za nečinné od okamžiku, kdy jsou odpojené, i když jsou příkazy spuštěné v odpojené relaci.

Související odkazy

• Disconnect-PSSession
• Enter-PSSession
• Exit-PSSession
• Get-PSSession
• Get-PSSessionConfiguration
• New-PSSession
• New-PSSessionOption
• New-PSTransportOption
• Receive-PSSession
• Register-PSSessionConfiguration
• Remove-PSSession