Connect-PSSession

Modul:

Microsoft.PowerShell.Core Module

Újracsatlakozik a leválasztott munkamenetekhez.

Syntax

Name (Alapértelmezett)

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

Ez a parancsmag csak a Windows platformon érhető el.

A Connect-PSSession parancsmag újra csatlakozik a leválasztott, felhasználó által felügyelt PowerShell-munkamenetekhez (PSSessions). Olyan munkameneteken működik, amelyek szándékosan vannak leválasztva, például a Disconnect-PSSession parancsmag parancsmagjának vagy InDisconnectedSession paraméterének Invoke-Command használatával, valamint olyan munkameneteken, amelyek véletlenül megszakadtak, például egy ideiglenes hálózatkimaradás miatt.

Connect-PSSession csatlakozni tud az ugyanazon felhasználó által indított megszakadt munkamenethez. Ezek közé tartoznak azok, amelyeket más számítógépek más munkamenetei indítottak vagy leválasztottak.

Connect-PSSession A parancsmag használatával Enter-PSSession indított megszakított vagy bezárt munkamenetekhez, illetve interaktív munkamenetekhez azonban nem lehet csatlakozni. A munkameneteket nem csatlakoztathatja más felhasználók által indított munkamenetekhez, kivéve, ha megadhatja a munkamenetet létrehozó felhasználó hitelesítő adatait.

A Leválasztott munkamenetek funkcióval kapcsolatos további információkért lásd about_Remote_Disconnected_Sessions.

Ezt a parancsmagot a Windows PowerShell 3.0-ban vezettük be.

Példák

1. példa: Újracsatlakozás munkamenethez

Connect-PSSession -ComputerName Server01 -Name ITTask

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

Ez a parancs újra csatlakozik a ITTask Kiszolgáló01 számítógépen futó munkamenethez.

A kimenet azt mutatja, hogy a parancs sikeres volt. A munkamenet Opened és a rendelkezésre állásAvailable, ami azt jelzi, hogy parancsokat futtathat a munkamenetben.

2. példa: A leválasztás és az újracsatlakozás hatása

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

Ez a példa a munkamenet leválasztásának, majd újracsatlakozásának hatását mutatja be.

Az első parancs a Get-PSSession parancsmagot használja. A ComputerName paraméter nélkül a parancs csak az aktuális munkamenetben létrehozott munkameneteket kapja meg.

A kimenet azt mutatja, hogy a parancs lekéri a Backups munkamenetet a helyi számítógépen. A munkamenet Opened és a rendelkezésre állás.Available

A második parancs a Get-PSSession parancsmaggal lekéri az aktuális munkamenetben létrehozott PSSession objektumokat, és a Disconnect-PSSession parancsmaggal leválasztja a munkameneteket. A kimenet azt mutatja, hogy a Backups munkamenet megszakadt. A munkamenet Disconnected és a rendelkezésre állás.None

A harmadik parancs a Get-PSSession parancsmaggal lekéri az aktuális munkamenetben létrehozott PSSession objektumokat és a Connect-PSSession parancsmagot a munkamenetek újracsatlakoztatásához. A kimenet azt mutatja, hogy a Backups munkamenet újracsatlakozott. A munkamenet Opened és a rendelkezésre állás.Available

Ha a Connect-PSSession parancsmagot nem leválasztott munkameneten használja, a parancs nincs hatással a munkamenetre, és nem okoz hibákat.

3. példa: Parancsok sorozata vállalati forgatókönyvben

Ez a parancssorozat bemutatja, hogyan használható a Connect-PSSession parancsmag egy vállalati forgatókönyvben. Ebben az esetben a rendszergazda elindít egy hosszú ideig futó feladatot egy távoli számítógépen futó munkamenetben. A feladat elindítása után a rendszergazda megszakítja a munkamenetet, és hazamegy. Az este folyamán a rendszergazda bejelentkezik az otthoni számítógépére, és ellenőrzi, hogy a feladat futott-e, amíg be nem fejeződik.

A rendszergazda először létrehoz egy munkamenetet egy távoli számítógépen, és futtat egy szkriptet a munkamenetben. Az első parancs a New-PSSession parancsmaggal hozza létre a ITTask munkamenetet a Server01 távoli számítógépen. A parancs a ConfigurationName paramétert használja a ITTasks munkamenet-konfiguráció megadásához. A parancs menti a munkameneteket a $s változóban.

A második parancsmag Invoke-Command , amely elindít egy háttérfeladatot a változó munkamenetében $s . A FilePath paraméterrel futtatja a szkriptet a háttérfeladatban.

A harmadik parancs a Disconnect-PSSession parancsmaggal választja le a változó munkamenetét $s . A parancs a OutputBufferingMode paramétert használja egy olyan értékkel Drop , amely megakadályozza a szkript letiltását azáltal, hogy kimenetet kell kézbesítenie a munkamenetnek. Az IdleTimeoutSec paraméter használatával 15 órára meghosszabbítja a munkamenet időtúllépését. A parancs végrehajtása után a rendszergazda zárolja a számítógépet, és hazamegy estére.

Az este folyamán a rendszergazda elindítja az otthoni számítógépét, bejelentkezik a vállalati hálózatba, és elindítja a PowerShellt. A negyedik parancs a Get-PSSession parancsmaggal szerzi be a munkameneteket a Server01 számítógépen. A parancs megkeresi a munkamenetet ITTask . Az ötödik parancs a Connect-PSSession parancsmaggal csatlakozik a ITTask munkamenethez. A parancs menti a munkamenetet a $s változóban.

A hatodik parancs a Invoke-Command parancsmaggal futtat egy Get-Job parancsot a változó munkamenetében $s . A kimenet azt mutatja, hogy a feladat sikeresen befejeződött. A hetedik parancs a Invoke-Command parancsmaggal futtat egy Receive-Job parancsot a munkamenetben a $s munkamenet változójában. A parancs menti az eredményeket a $BackupSpecs változóban. A nyolcadik parancs a Invoke-Command parancsmaggal futtat egy másik szkriptet a munkamenetben. A parancs a munkamenet változójának $BackupSpecs értékét használja a szkript bemeneteként.

$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

A kilencedik parancs megszakítja a munkamenetet a $s változóban. A rendszergazda bezárja a PowerShellt, és bezárja a számítógépet. A következő napon újra csatlakozhat a munkamenethez, és ellenőrizheti a szkript állapotát a munkahelyi számítógépéről.

Paraméterek

-AllowRedirection

Azt jelzi, hogy ez a parancsmag lehetővé teszi a kapcsolat átirányítását egy másik URI-ra.

Ha a ConnectionURI paramétert használja, a távoli cél egy utasítást adhat vissza egy másik URI-ra való átirányításhoz. A PowerShell alapértelmezés szerint nem irányítja át a kapcsolatokat, de ezzel a paramétersel engedélyezheti a kapcsolat átirányítását.

A MaximumConnectionRedirectionCount munkamenetbeállítás értékének módosításával azt is korlátozhatja, hogy a rendszer hányszor irányítsa át a kapcsolatot. Használja a parancsmag New-PSSessionOption paraméterét, vagy állítsa be a $PSSessionOption beállítási változó MaximumConnectionRedirectionCount tulajdonságát. Az alapértelmezett érték a 5.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

ConnectionUriGuid

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

ConnectionUri

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-ApplicationName

Egy alkalmazás nevét adja meg. Ez a parancsmag csak a megadott alkalmazást használó munkamenetekhez csatlakozik.

Adja meg a kapcsolati URI alkalmazásnév-szegmensét. Az alábbi kapcsolati URI-ban például az alkalmazás neve WSMan: http://localhost:5985/WSMAN. A munkamenet alkalmazásnevét a rendszer a munkamenet Runspace.ConnectionInfo.AppName tulajdonságában tárolja.

Ennek a paraméternek az értéke a munkamenetek kiválasztására és szűrésére szolgál. A munkamenet által használt alkalmazást nem módosítja.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

ComputerNameGuid

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

ComputerName

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-Authentication

Megadja a parancs felhasználói hitelesítő adatainak hitelesítésére használt mechanizmust a leválasztott munkamenethez való újracsatlakozáshoz. A paraméter elfogadható értékei a következők:

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

Az alapértelmezett érték a Default.

A paraméter értékeivel kapcsolatos további információkért lásd AuthenticationMechanism Enumeration.

Figyelmeztetés

A hitelesítő adatok biztonsági támogatási szolgáltatójának (CredSSP) hitelesítése, amelyben a felhasználó hitelesítő adatai átadva vannak egy hitelesítendő távoli számítógépnek, olyan parancsokhoz készült, amelyek több erőforráson is hitelesítést igényelnek, például távoli hálózati megosztáshoz való hozzáféréshez. Ez a mechanizmus növeli a távoli művelet biztonsági kockázatát. Ha a távoli számítógép biztonsága sérül, a neki átadott hitelesítő adatokkal szabályozható a hálózati munkamenet.

Paramétertulajdonságok

Típus:	AuthenticationMechanism
Alapértelmezett érték:	None
Elfogadott értékek:	Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

ComputerNameGuid

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

ComputerName

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

ConnectionUriGuid

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

ConnectionUri

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-CertificateThumbprint

Megadja egy olyan felhasználói fiók digitális nyilvános kulcsú tanúsítványát (X509), amely jogosult csatlakozni a leválasztott munkamenethez. Adja meg a tanúsítvány ujjlenyomatát.

A tanúsítványok az ügyféltanúsítvány-alapú hitelesítésben használatosak. Ezek csak helyi felhasználói fiókokra képezhetők le. Nem működnek tartományi fiókokkal.

Tanúsítvány ujjlenyomatának lekéréséhez használjon egy Get-Item vagy Get-ChildItem parancsot a PowerShell Cert: meghajtón.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

ComputerNameGuid

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

ComputerName

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

ConnectionUriGuid

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

ConnectionUri

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-ComputerName

Megadja azokat a számítógépeket, amelyeken a leválasztott munkamenetek tárolódnak. A munkamenetek a kiszolgálóoldali vagy a kapcsolat végét fogadó számítógépen vannak tárolva. Az alapértelmezett beállítás a helyi számítógép.

Írja be egy számítógép NetBIOS-nevét, IP-címét vagy teljes tartománynevét. A helyettesítő karakterek nem engedélyezettek. A helyi számítógép megadásához írja be a számítógép nevét vagy localhostegy pont (.)

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Cn

Paraméterkészletek

ComputerNameGuid

Position:	Named
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

ComputerName

Position:	Named
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-ConfigurationName

Csak a megadott munkamenet-konfigurációt használó munkamenetekhez csatlakozik.

Adja meg a konfiguráció nevét vagy a munkamenet-konfiguráció teljes minősített erőforrás-URI-ját. Ha csak a konfiguráció nevét adja meg, a következő séma URI-ja elő van állítva: http://schemas.microsoft.com/powershell. A munkamenet konfigurációs neve a munkamenet ConfigurationName tulajdonságában van tárolva.

Ennek a paraméternek az értéke a munkamenetek kiválasztására és szűrésére szolgál. Nem módosítja a munkamenet által használt munkamenet-konfigurációt.

További információ a munkamenet-konfigurációkról: about_Session_Configurations.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

ComputerNameGuid

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

ComputerName

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

ConnectionUriGuid

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

ConnectionUri

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-Confirm

Megerősítést kér a parancsmag futtatása előtt.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Cf

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-ConnectionUri

A leválasztott munkamenetek kapcsolati végpontjainak URI-jait adja meg.

Az URI-nak teljes mértékben minősítettnek kell lennie. A sztring formátuma a következő:

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

Az alapértelmezett érték a következő:

http://localhost:5985/WSMAN

Ha nem ad meg kapcsolati URI-t, a UseSSL és Port paraméterrel adhatja meg a kapcsolat URI-értékeit.

Az URI Átviteli szegmensének érvényes értékei a HTTP és a HTTPS. Ha egy átviteli szegmenshez tartozó kapcsolati URI-t ad meg, de nem ad meg portot, a munkamenet szabványportokkal jön létre: http-hez 80 és HTTPS-443. A PowerShell-újraküldés alapértelmezett portjának használatához adja meg a HTTP-hez 5985 vagy a HTTPS-5986 portot.

Ha a célszámítógép átirányítja a kapcsolatot egy másik URI-ra, a PowerShell megakadályozza az átirányítást, kivéve, ha a parancsban az AllowRedirection paramétert használja.

Paramétertulajdonságok

Típus:	Uri[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	URI, CU

Paraméterkészletek

ConnectionUriGuid

Position:	0
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

ConnectionUri

Position:	0
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-Credential

Olyan felhasználói fiókot ad meg, amely rendelkezik engedéllyel a leválasztott munkamenethez való csatlakozáshoz. Az alapértelmezett az aktuális felhasználó.

Írjon be egy felhasználónevet, például User01 vagy Domain01\User01írjon be egy PSCredential objektumot, amelyet a Get-Credential parancsmag generál. Ha beír egy felhasználónevet, a rendszer kéri a jelszó megadását.

A hitelesítő adatokat egy PSCredential objektum tárolja, a jelszó pedig SecureString.

Megjegyzés:

További információért a SecureString adatvédelemről lásd: Mennyire biztonságos a SecureString?.

Paramétertulajdonságok

Típus:	PSCredential
Alapértelmezett érték:	Current user
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

ComputerNameGuid

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

ComputerName

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

ConnectionUriGuid

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

ConnectionUri

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Id

Megadja a leválasztott munkamenetek azonosítóit. Az id paraméter csak akkor működik, ha a leválasztott munkamenet korábban az aktuális munkamenethez volt csatlakoztatva.

Ez a paraméter érvényes, de nem érvényes, ha a munkamenet a helyi számítógépen van tárolva, de nem csatlakozott az aktuális munkamenethez.

Paramétertulajdonságok

Típus:	Int32[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

Id

Position:	0
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-InstanceId

Megadja a leválasztott munkamenetek példányazonosítóit.

A példányazonosító egy GUID, amely egyedileg azonosít egy PSSession egy helyi vagy távoli számítógépen futó példányát.

A példányazonosító a InstanceID tulajdonságban van tárolva a PSSession.

Paramétertulajdonságok

Típus:	Guid[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

ComputerNameGuid

Position:	Named
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

ConnectionUriGuid

Position:	Named
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

InstanceId

Position:	Named
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Name

Megadja a leválasztott munkamenetek rövid nevét.

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

Name

Position:	Named
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

ComputerName

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

ConnectionUri

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Port

Megadja a távoli számítógépen a munkamenethez való újracsatlakozáshoz használt hálózati portot. Távoli számítógéphez való csatlakozáshoz a távoli számítógépnek a kapcsolat által használt portot kell figyelnie. Az alapértelmezett portok a 5985, amely a HTTP WinRM-portja, és 5986, amely a HTTPS WinRM-portja.

Egy másik port használata előtt konfigurálnia kell a WinRM-figyelőt a távoli számítógépen az adott port figyelésére. A figyelő konfigurálásához írja be a következő két parancsot a PowerShell-parancssorba:

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

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

Ne használja a Port paramétert, hacsak nem szükséges. A parancsban beállított port az összes olyan számítógépre vagy munkamenetre vonatkozik, amelyen a parancs fut. Egy másik portbeállítás megakadályozhatja, hogy a parancs minden számítógépen fusson.

Paramétertulajdonságok

Típus:	Int32
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

ComputerNameGuid

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

ComputerName

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Session

A leválasztott munkameneteket adja meg. Adjon meg egy változót, amely tartalmazza a PSSession objektumokat, vagy egy parancsot, amely létrehozza vagy lekéri a PSSession objektumokat, például egy parancsot Get-PSSession .

Paramétertulajdonságok

Típus:	PSSession[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

Session

Position:	0
Kötelező:	True
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-SessionOption

A munkamenet speciális beállításait adja meg. Adjon meg egy SessionOption objektumot, például a New-PSSessionOption parancsmaggal létrehozott objektumot, vagy egy kivonattáblát, amelyben a kulcsok munkamenet-beállításnevek, az értékek pedig munkamenet-beállításértékek.

A beállítások alapértelmezett értékeit a $PSSessionOption beállítási változó értéke határozza meg, ha be van állítva. Ellenkező esetben az alapértelmezett értékeket a munkamenet-konfigurációban megadott beállítások állítják be.

A munkamenet-beállításértékek elsőbbséget élveznek a $PSSessionOption beállítási változóban és a munkamenet-konfigurációban beállított munkamenetek alapértelmezett értékeivel szemben. Azonban nem elsőbbséget élveznek a munkamenet-konfigurációban beállított maximális értékekkel, kvótával vagy korlátokkal szemben.

Az alapértelmezett értékeket tartalmazó munkamenet-beállítások leírását lásd: New-PSSessionOption. A $PSSessionOption beállítási változóval kapcsolatos információkért lásd: about_Preference_Variables. További információ a munkamenet-konfigurációkról: about_Session_Configurations.

Paramétertulajdonságok

Típus:	PSSessionOption
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

ComputerNameGuid

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

ComputerName

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

ConnectionUriGuid

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

ConnectionUri

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-ThrottleLimit

Megadja a parancs futtatásához létrehozható egyidejű kapcsolatok maximális számát. Ha kihagyja ezt a paramétert, vagy 0értéket ad meg, a rendszer az alapértelmezett 32értéket használja.

A szabályozás korlátja csak az aktuális parancsra vonatkozik, a munkamenetre és a számítógépre nem.

Paramétertulajdonságok

Típus:	Int32
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-UseSSL

Azt jelzi, hogy ez a parancsmag a Secure Sockets Layer (SSL) protokollt használja a leválasztott munkamenethez való csatlakozáshoz. Alapértelmezés szerint az SSL nem használatos.

WS-Management titkosítja a hálózaton keresztül továbbított összes PowerShell-tartalmat. A UseSSL paraméter egy további védelem, amely HTTP-kapcsolat helyett HTTPS-kapcsolaton keresztül küldi az adatokat.

Ha ezt a paramétert használja, de az SSL nem érhető el a parancshoz használt porton, a parancs meghiúsul.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

ComputerNameGuid

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

ComputerName

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-WhatIf

Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Wi

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

PSSession

Ehhez a parancsmaghoz futtathat munkamenetet (PSSession).

Kimenetek

PSSession

Ez a parancsmag egy objektumot ad vissza, amely azt a munkamenetet jelöli, amelyhez újracsatlakozott.

Jegyzetek

A PowerShell a következő aliasokat tartalmazza Connect-PSSession:

• Windows:

  • cnsn

• Ez a parancsmag csak Windows-platformokon érhető el.

• Connect-PSSession Csak a leválasztott munkamenetekhez csatlakozik újra, vagyis azokhoz a munkamenetekhez, amelyek az Állapot tulajdonságban leválasztva értékkel rendelkeznek. Csak a Windows PowerShell 3.0-s vagy újabb verzióit futtató számítógépekhez csatlakoztatott vagy ott végződő munkamenetek kapcsolhatók le és kapcsolhatók újra.

• Ha olyan munkamenetet használ Connect-PSSession , amely nincs leválasztva, a parancs nincs hatással a munkamenetre, és nem okoz hibákat.

• A leválasztott visszacsatolási munkamenetek interaktív jogkivonatokkal, amelyek az EnableNetworkAccess paraméter használatával jönnek létre, csak attól a számítógéptől csatlakoztathatók újra, amelyen a munkamenet létre lett hozva. Ez a korlátozás védi a számítógépet a rosszindulatú hozzáféréstől.

• Egy PSSessionState tulajdonságának értéke az aktuális munkamenethez viszonyítva van. Ezért a leválasztott értéke azt jelenti, hogy a PSSession nincs csatlakoztatva az aktuális munkamenethez. Ez azonban nem jelenti azt, hogy a PSSession leválasztva van az összes munkamenetről. Lehet, hogy egy másik munkamenethez csatlakozik. Annak megállapításához, hogy tud-e csatlakozni vagy újra csatlakozni a munkamenethez, használja a Rendelkezésre állási tulajdonságot.

  A Rendelkezésre állás értéke None azt jelzi, hogy csatlakozhat a munkamenethez. A Foglalt érték azt jelzi, hogy nem tud csatlakozni a PSSession, mert egy másik munkamenethez van csatlakoztatva.

  A munkamenetek State tulajdonságának értékeiről további információt RunspaceState Enumerationcímű témakörben talál.

  A munkamenetek Rendelkezésre állási tulajdonságának értékeiről a RunspaceAvailability Enumerationcímű talál további információt.

• Az PSSession tétlen időtúllépési értékét nem módosíthatja, ha a pssessioncsatlakozik. A Connect-PSSession paramétere egy SessionOption objektumot vesz fel, amely IdleTimeout értékkel rendelkezik. A SessionOption objektum IdleTimeout értéke és a változó $PSSessionOption értéke azonban figyelmen kívül lesz hagyva a PSSession-hez való csatlakozáskor.

  A PSSession tétlenségi időtúllépését beállíthatja és módosíthatja a PSSessionlétrehozásakor a New-PSSession vagy Invoke-Command parancsmagok használatával, és amikor leválasztja magát a PSSession-ről.

  A PSSessionIdleTimeout tulajdonsága kritikus fontosságú a leválasztott munkamenetek szempontjából, mivel meghatározza, hogy mennyi ideig tart fenn a leválasztott munkamenet a távoli számítógépen. A leválasztott munkamenetek inaktívnak minősülnek attól a pillanattól kezdve, amikor le vannak választva, még akkor is, ha a parancsok a leválasztott munkamenetben futnak.

Kapcsolódó hivatkozások

• Disconnect-PSSession
• Enter-PSSession (PowerShell parancs a távoli számítógéppel való interaktív munkamenet indítására)
• Exit-PSSession
• Get-PSSession
• Get-PSSessionConfiguration (PSSession konfiguráció lekérése)
• New-PSSession
• New-PSSessionOption
• New-PSTransportOption
• Receive-PSSession
• Register-PSSessionConfiguration
• Remove-PSSession parancs eltávolít egy PSSession-t