Connect-PSSession
Újracsatlakozik a leválasztott munkamenetekhez.
Syntax
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
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 AvailableEz 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 állapota é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 AvailableEz 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 állapota é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 állapota é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 állapota é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 NoneA 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.
A ConnectionURI paraméter használatakor 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 munkamenet beá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 MaximumRedirection paraméterétNew-PSSessionOption, vagy állítsa be a $PSSessionOption beállítási változó MaximumConnectionRedirectionCount tulajdonságát. Az alapértelmezett érték 5.
| Típus: | SwitchParameter |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | 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.
| Típus: | String |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | 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:
DefaultBasicCredsspDigestKerberosNegotiateNegotiateWithImplicitCredential
Az alapértelmezett érték Default.
A paraméter értékeivel kapcsolatos további információkért lásd : AuthenticationMechanism Enumeration.
Figyelemfelhívá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.
| Típus: | AuthenticationMechanism |
| Elfogadott értékek: | Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | 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 vagy Get-ChildItem több Get-Item parancsot a PowerShell-meghajtónCert:.
| Típus: | String |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | 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. Alapértelmezés szerint 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 (.)
| Típus: | String[] |
| Aliasok: | Cn |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | 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 erőforrás-URI-címét. Ha csak a konfiguráció nevét adja meg, a rendszer a következő séma URI-ját előpendálta: 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.
A munkamenet-konfigurációkkal kapcsolatos további tudnivalókért tekintse meg az about_Session_Configuration_Files című témakört.
| Típus: | String |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | False |
-Confirm
Jóváhagyást kér a parancsmag futtatása előtt.
| Típus: | SwitchParameter |
| Aliasok: | cf |
| Position: | Named |
| Alapértelmezett érték: | False |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | 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 a Port paraméterekkel megadhatja 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: 80 HTTP-hez és 443 HTTPS-hez. A PowerShell-újraküldés alapértelmezett portjának használatához adja meg a HTTP-portot 5985 vagy 5986 a HTTPS-t.
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, hacsak nem használja az AllowRedirection paramétert a parancsban.
| Típus: | Uri[] |
| Aliasok: | URI, CU |
| Position: | 0 |
| Alapértelmezett érték: | None |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | False |
-Credential
Olyan felhasználói fiókot ad meg, amely rendelkezik engedéllyel a leválasztott munkamenethez való csatlakozáshoz. Alapértelmezés szerint 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 PSCredential objektum tárolja, a jelszót pedig SecureStringként tárolja a rendszer.
Feljegyzés
További információ a SecureString adatvédelemről: Mennyire biztonságos a SecureString?.
| Típus: | PSCredential |
| Position: | Named |
| Alapértelmezett érték: | Current user |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-Id
Megadja a leválasztott munkamenetek azonosítóit. Az Azonosító paraméter csak akkor működik, ha a leválasztott munkamenet korábban csatlakozott az aktuális munkamenethez.
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.
| Típus: | Int32[] |
| Position: | 0 |
| Alapértelmezett érték: | None |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | False |
-InstanceId
Megadja a leválasztott munkamenetek példányazonosítóit.
A példányazonosító egy GUID, amely egyedileg azonosítja a PSSessiont egy helyi vagy távoli számítógépen.
A példányazonosító a PSSession InstanceID tulajdonságában van tárolva.
| Típus: | Guid[] |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-Name
Megadja a leválasztott munkamenetek rövid nevét.
| Típus: | String[] |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | 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 5985a HTTP WinRM-portja, és 5986a 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\>
Csak akkor használja a Port paramétert, ha kötelező. 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.
| Típus: | Int32 |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | 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 .
| Típus: | PSSession[] |
| Position: | 0 |
| Alapértelmezett érték: | None |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | False |
-SessionOption
A munkamenet speciális beállításait adja meg. Adjon meg egy SessionOption objektumot, például a parancsmaggal New-PSSessionOption 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 beállítási változó értéke $PSSessionOption 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 beállításváltozóban és a $PSSessionOption 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. A munkamenet-konfigurációkkal kapcsolatos további tudnivalókért tekintse meg az about_Session_Configuration_Files című témakört.
| Típus: | PSSessionOption |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-ThrottleLimit
Megadja a parancs futtatásához létrehozható egyidejű kapcsolatok maximális számát.
Ha kihagyja ezt a paramétert, vagy az alapértelmezett értéket 0adja meg, 32akkor a rendszer ezt a paramétert használja.
A szabályozás korlátja csak az aktuális parancsra vonatkozik, a munkamenetre és a számítógépre nem.
| Típus: | Int32 |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | 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.
A WS-Management a hálózaton keresztül továbbított összes PowerShell-tartalmat titkosítja. 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.
| Típus: | SwitchParameter |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-WhatIf
Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.
| Típus: | SwitchParameter |
| Aliasok: | wi |
| Position: | Named |
| Alapértelmezett érték: | False |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
Bevitelek
Ehhez a parancsmaghoz futtathat munkamenetet (PSSession).
Kimenetek
Ez a parancsmag egy objektumot ad vissza, amely azt a munkamenetet jelöli, amelyhez újracsatlakozott.
Jegyzetek
A PowerShell a következő aliasokat Connect-PSSessiontartalmazza:
Windows:
cnsn
Ez a parancsmag csak Windows-platformokon érhető el.
Connect-PSSessionCsak 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.Az EnableNetworkAccess paraméterrel létrehozott interaktív jogkivonatokkal rendelkező leválasztott visszacsatolási munkamenetek 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.
A PSSession State tulajdonságának értéke az aktuális munkamenethez viszonyítva van. Ezért a leválasztott érték 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 csatlakozhat-e a munkamenethez, vagy újracsatlakozhat-e, használja a Rendelkezésre állás tulajdonságot .
A Nincs rendelkezésre állás értéke azt jelzi, hogy csatlakozhat a munkamenethez. A Foglalt érték azt jelzi, hogy nem tud csatlakozni a PSSessionhoz , mert egy másik munkamenethez van csatlakoztatva.
A munkamenetek State tulajdonságának értékeiről további információt a RunspaceState Enumerálás című témakörben talál.
A munkamenetek Rendelkezésre állási tulajdonságának értékeiről további információt a RunspaceAvailability Enumeration című témakörben talál.
A PSSessionhoz való csatlakozáskor nem módosíthatja a PSSession tétlenségi időtúllépési értékét. A SessionOption paraméter
Connect-PSSessionegy IdleTimeout értékkel rendelkező SessionOption objektumot vesz fel. A SessionOption objektum IdleTimeout értéke és a$PSSessionOptionváltozó IdleTimeout értéke azonban figyelmen kívül lesz hagyva a PSSession-hez való csatlakozáskor.A PSSession létrehozásakor, a parancsmagok vagy
Invoke-Commandparancsmagok használatávalNew-PSSession, valamint a PSSession-ről való leválasztáskor beállíthatja és módosíthatja a PSSession tétlen időtúllépését.A PSSession IdleTimeout 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.
