Connect-PSSession

Modul:

Microsoft.PowerShell.Core Module

Znovu se připojí k odpojeným relacím.

Syntax

Name (Výchozí)

Connect-PSSession
    -Name <String[]>
    [-ThrottleLimit <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Session

Connect-PSSession
    [-Session] <PSSession[]>
    [-ThrottleLimit <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ComputerNameGuid

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

ComputerName

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

ConnectionUriGuid

Connect-PSSession
    [-ConnectionUri] <Uri[]>
    -InstanceId <Guid[]>
    [-ConfigurationName <String>]
    [-AllowRedirection]
    [-Credential <PSCredential>]
    [-Authentication <AuthenticationMechanism>]
    [-CertificateThumbprint <String>]
    [-SessionOption <PSSessionOption>]
    [-ThrottleLimit <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ConnectionUri

Connect-PSSession
    [-ConnectionUri] <Uri[]>
    [-ConfigurationName <String>]
    [-AllowRedirection]
    [-Name <String[]>]
    [-Credential <PSCredential>]
    [-Authentication <AuthenticationMechanism>]
    [-CertificateThumbprint <String>]
    [-SessionOption <PSSessionOption>]
    [-ThrottleLimit <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InstanceId

Connect-PSSession
    -InstanceId <Guid[]>
    [-ThrottleLimit <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Id

Connect-PSSession
    [-Id] <Int32[]>
    [-ThrottleLimit <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í rutiny Disconnect-PSSession nebo InDisconnectedSession parametru rutiny Invoke-Command 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 se ale nemůže připojit k přerušeným nebo uzavřeným relacím nebo interaktivním relacím spuštěným pomocí rutiny Enter-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 naleznete 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 relaci ITTask na počítači se serverem Server01.

Výstup ukazuje, že příkaz byl úspěšný. Stav relace je Opened a Dostupnost je Available, což znamená, ž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á relaci Backups na místním počítači. Stav relace je Opened a dostupnosti je Available.

Druhý příkaz používá rutinu Get-PSSession k získání psSession objektů vytvořených v aktuální relaci a rutiny Disconnect-PSSession k odpojení relací. Výstup ukazuje, že relace Backups byla odpojena. Stav relace je Disconnected a dostupnosti je None.

Třetí příkaz používá rutinu Get-PSSession k získání PSSession objektů vytvořených v aktuální relaci a rutiny Connect-PSSession k opětovnému připojení relací. Výstup ukazuje, že se relace Backups znovu připojila. Stav relace je Opened a dostupnosti 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 může rutina Connect-PSSession použít 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 používá rutinu New-PSSession k vytvoření relace ITTask na vzdáleném počítači Serveru01. Příkaz používá parametr ConfigurationName k určení konfigurace relace ITTasks. Příkaz uloží relace do proměnné $s.

Druhý příkaz Invoke-Command rutinu, která spustí úlohu na pozadí v relaci v proměnné $s. Ke spuštění skriptu v úloze na pozadí používá parametr FilePath.

Třetí příkaz používá rutinu Disconnect-PSSession k odpojení od relace v proměnné $s. Příkaz používá parametr OutputBufferingMode s hodnotou Drop, aby se zabránilo zablokování skriptu tím, že bude muset 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 se serverem Server01. Příkaz najde ITTask relaci. Pátý příkaz používá rutinu Connect-PSSession pro připojení k relaci ITTask. Příkaz uloží relaci do proměnné $s.

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

Označuje, že tato rutina umožňuje přesměrování tohoto připojení na alternativní identifikátor URI.

Pokud použijete parametr ConnectionURI, vzdálený cíl může vrátit pokyn k přesměrování na jiný identifikátor URI. PowerShell ve výchozím nastavení nesměruje připojení, ale pomocí tohoto parametru ho můžete přesměrovat.

Můžete také omezit počet přesměrování připojení změnou nastavení hodnoty možnosti MaximumConnectionRedirectionCount relace. Použijte parametr MaximumRedirection rutiny New-PSSessionOption nebo nastavte vlastnost MaximumConnectionRedirectionCount proměnné předvolby $PSSessionOption. Výchozí hodnota je 5.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

ConnectionUriGuid

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

ConnectionUri

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ApplicationName

Určuje název aplikace. Tato rutina se připojí pouze k relacím, které používají zadanou aplikaci.

Zadejte segment názvu aplikace jako URI pro připojení. Například v následujícím identifikátoru URI připojení je název aplikace WSMan: http://localhost:5985/WSMAN. Název aplikace relace je uložen v Runspace.ConnectionInfo.AppName vlastnost relace.

Hodnota tohoto parametru slouží k výběru a filtrování relací. Nemění aplikaci, kterou relace používá.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

ComputerNameGuid

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

ComputerName

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Authentication

Určuje mechanismus, který se používá k ověření přihlašovacích údajů uživatele v příkazu, aby se znovu připojil k odpojené relaci. Přijatelné hodnoty pro tento parametr jsou:

• Default
• Basic
• Credssp
• Digest
• Kerberos
• Negotiate
• NegotiateWithImplicitCredential

Výchozí hodnota je Default.

Další informace o hodnotách tohoto parametru naleznete v tématu AuthenticationMechanism – výčet.

Upozornění

Ověřování zprostředkovatele podpory zabezpečení přihlašovacích údajů (CredSSP), ve kterém jsou přihlašovací údaje uživatele předány vzdálenému počítači pro ověření, je navrženo pro příkazy, které vyžadují ověření u více než jednoho prostředku, jako například přístup k síťové sdílené složce na dálku. Tento mechanismus zvyšuje riziko zabezpečení vzdálené operace. Pokud dojde k ohrožení zabezpečení vzdáleného počítače, dají se k řízení síťové relace použít přihlašovací údaje, které jsou mu předány.

Vlastnosti parametru

Typ:	AuthenticationMechanism
Default value:	None
Přípustné hodnoty:	Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

ComputerNameGuid

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

ComputerName

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

ConnectionUriGuid

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

ConnectionUri

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-CertificateThumbprint

Určuje certifikát digitálního veřejného klíče (X509) uživatelského účtu, který má oprávnění k připojení k odpojené relaci. Zadejte kryptografický otisk certifikátu.

Certifikáty se používají při ověřování na základě klientských certifikátů. Je možné je mapovat pouze na místní uživatelské účty. Nefungují s doménovými účty.

Pokud chcete získat kryptografický otisk certifikátu, použijte příkaz Get-Item nebo Get-ChildItem na jednotce PowerShellu Cert:.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

ComputerNameGuid

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

ComputerName

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

ConnectionUriGuid

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

ConnectionUri

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ComputerName

Určuje počítače, na kterých jsou uloženy odpojené relace. Relace se ukládají na počítači, který je na straně serveru nebo na konci připojení. Výchozí hodnota je místní počítač.

Zadejte název NetBIOS, IP adresu nebo plně kvalifikovaný název domény jednoho počítače. Zástupné znaky nejsou povoleny. Chcete-li zadat místní počítač, zadejte název počítače, localhostnebo tečku (.)

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Kn

Sady parametrů

ComputerNameGuid

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

ComputerName

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ConfigurationName

Připojí se pouze k relacím, které používají zadanou konfiguraci relace.

Zadejte název konfigurace nebo plně kvalifikovanou URI prostředku pro konfiguraci relace. Pokud zadáte pouze název konfigurace, předzálohuje se následující identifikátor URI schématu: http://schemas.microsoft.com/powershell. Název konfigurace relace je uložen v ConfigurationName vlastnosti relace.

Hodnota tohoto parametru slouží k výběru a filtrování relací. Nezmění konfiguraci relace, kterou relace používá.

Další informace o konfiguracích relací naleznete v části about_Session_Configurations.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

ComputerNameGuid

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

ComputerName

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

ConnectionUriGuid

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

ConnectionUri

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Confirm

Před spuštěním cmdletu vás vyzve k potvrzení.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	viz

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ConnectionUri

Určuje identifikátory URI koncových bodů připojení pro odpojené relace.

Identifikátor URI musí být plně kvalifikovaný. Formát tohoto řetězce je následující:

<Transport>://<ComputerName>:<Port>/<ApplicationName>

Výchozí hodnota je následující:

http://localhost:5985/WSMAN

Pokud nezadáte identifikátor URI připojení, můžete k určení hodnot identifikátoru URI připojení použít UseSSL a port.

Platné hodnoty pro segment Transport identifikátoru URI jsou HTTP a HTTPS. Pokud zadáte identifikátor URI připojení s přenosovým segmentem, ale nezadáte port, relace se vytvoří s porty standardů: 80 pro HTTP a 443 HTTPS. Pokud chcete použít výchozí porty pro vzdálené komunikace PowerShellu, zadejte 5985 portu pro PROTOKOL HTTP nebo 5986 pro HTTPS.

Pokud cílový počítač přesměruje připojení na jiný identifikátor URI, PowerShell zabrání přesměrování, pokud v příkazu nepoužijete parametr AllowRedirection.

Vlastnosti parametru

Typ:	Uri[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	identifikátor URI, CU

Sady parametrů

ConnectionUriGuid

Position:	0
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

ConnectionUri

Position:	0
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Credential

Určuje uživatelský účet, který má oprávnění k připojení k odpojené relaci. Výchozí hodnota je aktuální uživatel.

Zadejte uživatelské jméno, například User01 nebo Domain01\User01, nebo zadejte objekt PSCredential vygenerovaný rutinou Get-Credential. Pokud zadáte uživatelské jméno, zobrazí se výzva k zadání hesla.

Přihlašovací údaje jsou uloženy v objektu PSCredential a heslo je uloženo jako SecureString.

Poznámka:

Další informace o ochraně dat SecureString najdete v tématu Jak zabezpečený je SecureString?.

Vlastnosti parametru

Typ:	PSCredential
Default value:	Current user
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

ComputerNameGuid

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

ComputerName

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

ConnectionUriGuid

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

ConnectionUri

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Id

Určuje ID odpojených relací. Parametr ID funguje pouze v případech, kdy byla odpojená relace dříve připojena k aktuální relaci.

Tento parametr je platný, ale není efektivní, pokud je relace uložena v místním počítači, ale nebyla připojena k aktuální relaci.

Vlastnosti parametru

Typ:	Int32[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

Id

Position:	0
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-InstanceId

Určuje ID instancí odpojených relací.

ID instance je identifikátor GUID, který jednoznačně identifikuje PSSession na místním nebo vzdáleném počítači.

ID instance je uloženo v InstanceID vlastnost PSSession.

Vlastnosti parametru

Typ:	Guid[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

ComputerNameGuid

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

ConnectionUriGuid

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

InstanceId

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Name

Určuje popisné názvy odpojených relací.

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

Name

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

ComputerName

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

ConnectionUri

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Port

Určuje síťový port na vzdáleném počítači, který se používá k opětovnému připojení k relaci. Pokud se chcete připojit ke vzdálenému počítači, musí vzdálený počítač naslouchat na portu, který připojení používá. Výchozí porty jsou 5985, což je port WinRM pro HTTP a 5986, což je port WinRM pro HTTPS.

Před použitím alternativního portu musíte nakonfigurovat naslouchací proces WinRM na vzdáleném počítači tak, aby naslouchal na tomto portu. Pokud chcete nakonfigurovat naslouchací proces, na příkazovém řádku PowerShellu zadejte následující dva příkazy:

Remove-Item -Path WSMan:\Localhost\listener\listener* -Recurse

New-Item -Path WSMan:\Localhost\listener -Transport http -Address * -Port \<port-number\>

Nepoužívejte parametr Port, pokud není nutné. Port nastavený v příkazu se vztahuje na všechny počítače nebo relace, na kterých se příkaz spouští. Alternativní nastavení portu může zabránit spuštění příkazu na všech počítačích.

Vlastnosti parametru

Typ:	Int32
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

ComputerNameGuid

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

ComputerName

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Session

Určuje odpojené relace. Zadejte proměnnou, která obsahuje psSession objekty nebo příkaz, který vytvoří nebo získá PSSession objekty, například příkaz Get-PSSession.

Vlastnosti parametru

Typ:	PSSession[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

Session

Position:	0
Povinné:	True
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-SessionOption

Určuje pokročilé možnosti relace. Zadejte objekt SessionOption, například objekt, který vytvoříte pomocí příkazu New-PSSessionOption, nebo tabulku hash, kde jsou klíče názvy možností relace a hodnoty jsou hodnoty možností relace.

Výchozí hodnoty pro možnosti jsou určeny hodnotou proměnné předvoleb $PSSessionOption, pokud je nastavena. V opačném případě se výchozí hodnoty vytvoří pomocí možností nastavených v konfiguraci relace.

Hodnoty možností relace mají přednost před výchozími hodnotami relace nastavenými v proměnné předvoleb $PSSessionOption a v konfiguraci relace. Nemají však přednost před maximálními hodnotami, kvótami nebo limity nastavenými v konfiguraci relace.

Popis možností relace, které obsahují výchozí hodnoty, najdete v tématu New-PSSessionOption. Informace o proměnné předvoleb $PSSessionOption najdete v dokumentu about_Preference_Variables. Další informace o konfiguracích relací naleznete v části about_Session_Configurations.

Vlastnosti parametru

Typ:	PSSessionOption
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

ComputerNameGuid

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

ComputerName

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

ConnectionUriGuid

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

ConnectionUri

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ThrottleLimit

Určuje maximální počet souběžných připojení, která lze navázat pro spuštění tohoto příkazu. Pokud tento parametr vynecháte nebo zadáte hodnotu 0, použije se výchozí hodnota 32.

Omezení se vztahuje pouze na aktuální příkaz, ne na relaci nebo na počítač.

Vlastnosti parametru

Typ:	Int32
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-UseSSL

Označuje, že tato rutina používá protokol SSL (Secure Sockets Layer) pro připojení k odpojené relaci. Ve výchozím nastavení se ssl nepoužívá.

WS-Management šifruje veškerý obsah PowerShellu přenášený přes síť. Parametr UseSSL je dodatečná ochrana, která odesílá data přes připojení HTTPS místo připojení HTTP.

Pokud použijete tento parametr, ale protokol SSL není k dispozici na portu použitém pro příkaz, příkaz selže.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

ComputerNameGuid

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

ComputerName

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-WhatIf

Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Wi

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

PSSession

K této rutině můžete připojit 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

• Tento cmdlet je dostupný pouze na platformách Windows.

• Connect-PSSession se znovu připojí pouze k relacím, které jsou odpojeny, to znamená relace, které mají hodnotu Odpojeno pro vlastnost State. 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 v relaci, která není odpojena, příkaz nemá vliv na relaci a nevygeneruje chyby.

• Odpojené relace zpětné smyčky s interaktivními tokeny, které se vytvářejí 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 vlastnosti StatePSSes sion je relativní vzhledem k aktuální relaci. Proto hodnota Odpojeno znamená, že psSession není připojen k aktuální relaci. Neznamená však, že PSSession je odpojen od všech relací. Může být připojeno k jiné relaci. Pokud chcete zjistit, jestli se k relaci můžete připojit nebo znovu připojit, použijte vlastnost Availability.

  Hodnota Dostupnost None znamená, ž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 relace naleznete v tématu RunspaceState Výčtu.

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

• Hodnotu časového limitu nečinnosti PSSession nelze změnit při připojení k PSSession . Parametr SessionOption u Connect-PSSession bere objekt SessionOption, který má hodnotu IdleTimeout. Hodnota IdleTimeout objektu SessionOp tion a IdleTimeout hodnoty proměnné $PSSessionOption se při připojování k PSSession ignorují.

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

  Vlastnost IdleTimeout PSSession je důležitá pro odpojené relace, protože určuje, jak dlouho je odpojená relace udržována 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
• Příkaz Enter-PSSession
• Exit-PSSession
• Get-PSSession
• Get-PSSessionConfiguration
• New-PSSession
• New-PSSessionOption
• New-PSTransportOption
• Receive-PSSession
• Register-PSSessionConfiguration
• Remove-PSSession