Enter-PSSession
Interaktív munkamenet indítása távoli számítógéppel.
Syntax
Enter-PSSession
[-ComputerName] <String>
[-EnableNetworkAccess]
[[-Credential] <PSCredential>]
[-ConfigurationName <String>]
[-Port <Int32>]
[-UseSSL]
[-ApplicationName <String>]
[-SessionOption <PSSessionOption>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[<CommonParameters>]Enter-PSSession
[-HostName] <String>
[-Port <Int32>]
[-UserName <String>]
[-KeyFilePath <String>]
[-SSHTransport]
[-ConnectingTimeout <int>]
[<CommonParameters>]Enter-PSSession
[[-Session] <PSSession>]
[<CommonParameters>]Enter-PSSession
[[-ConnectionUri] <Uri>]
[-EnableNetworkAccess]
[[-Credential] <PSCredential>]
[-ConfigurationName <String>]
[-AllowRedirection]
[-SessionOption <PSSessionOption>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[<CommonParameters>]Enter-PSSession
[-InstanceId <Guid>]
[<CommonParameters>]Enter-PSSession
[[-Id] <Int32>]
[<CommonParameters>]Enter-PSSession
[-Name <String>]
[<CommonParameters>]Enter-PSSession
[-VMId] <Guid>
[-Credential] <PSCredential>
[-ConfigurationName <String>]
[<CommonParameters>]Enter-PSSession
[-VMName] <String>
[-Credential] <PSCredential>
[-ConfigurationName <String>]
[<CommonParameters>]Enter-PSSession
[-ContainerId] <String>
[-ConfigurationName <String>]
[-RunAsAdministrator]
[<CommonParameters>]Description
A Enter-PSSession parancsmag egy interaktív munkamenetet indít egyetlen távoli számítógéppel.
A munkamenet során a beírt parancsok ugyanúgy futnak a távoli számítógépen, mintha közvetlenül a távoli számítógépre gépelt volna. Egyszerre csak egy interaktív munkamenet lehet.
Általában a ComputerName paraméter használatával adja meg a távoli számítógép nevét.
Használhat azonban egy munkamenetet is, amelyet az New-PSSession interaktív munkamenet parancsmagjának használatával hoz létre. Az interaktív munkamenetek leválasztására vagy Receive-PSSession újracsatlakozására azonban nem használhatja a Disconnect-PSSessionparancsmagokatConnect-PSSession.
A PowerShell 6.0-tól kezdve a Secure Shell (SSH) használatával létesíthet kapcsolatot egy távoli számítógéppel, ha az SSH elérhető a helyi számítógépen, és a távoli számítógép PowerShell SSH-végponttal van konfigurálva. Az SSH-alapú Távoli PowerShell-munkamenet előnye, hogy több platformon (Windows, Linux, macOS) működik. SSH-alapú újraküldés esetén a HostName paraméterkészlettel adja meg a távoli számítógépet és a kapcsolódó kapcsolati adatokat. A PowerShell SSH-remoting beállításával kapcsolatos további információkért lásd : PowerShell Remoting Over SSH.
Az interaktív munkamenet befejezéséhez és a távoli számítógépről való leválasztásához használja a parancsmagot, vagy írja be a Exit-PSSession parancsmagot exit.
Példák
1. példa: Interaktív munkamenet indítása
PS> Enter-PSSession
[localhost]: PS>Ez a parancs egy interaktív munkamenetet indít el a helyi számítógépen. A parancssor úgy módosul, hogy mostantól egy másik munkamenetben futtat parancsokat.
A megadott parancsok az új munkamenetben futnak, és az eredmények szövegként jelennek meg az alapértelmezett munkamenetben.
2. példa: Interaktív munkamenettel végzett munka
Az első parancs a Enter-PSSession parancsmaggal indít egy interaktív munkamenetet a Server01 távoli számítógéppel. A munkamenet indításakor a parancssor úgy változik, hogy tartalmazza a számítógép nevét.
A második parancs lekéri a PowerShell-folyamatot, és átirányítja a kimenetet a Process.txt fájlba.
A parancs el lesz küldve a távoli számítógépre, és a fájl a távoli számítógépre lesz mentve.
A harmadik parancs a Kilépés kulcsszót használja az interaktív munkamenet befejezéséhez és a kapcsolat bezárásához.
A negyedik parancs megerősíti, hogy a Process.txt fájl a távoli számítógépen található. A Get-ChildItem helyi számítógépen egy ("dir") parancs nem találja a fájlt.
PS C:\> Enter-PSSession -ComputerName Server01
[Server01]: PS C:\>
[Server01]: PS C:\> Get-Process PowerShell > C:\ps-test\Process.txt
[Server01]: PS C:\> exit
PS C:\>
PS C:\> dir C:\ps-test\Process.txt
Get-ChildItem : Cannot find path 'C:\ps-test\Process.txt' because it does not exist.
At line:1 char:4
+ dir <<<< c:\ps-test\Process.txtEz a parancs bemutatja, hogyan dolgozhat interaktív munkamenetben távoli számítógéppel.
3. példa: A Munkamenet paraméter használata
PS> $s = New-PSSession -ComputerName Server01
PS> Enter-PSSession -Session $s
[Server01]: PS>Ezek a parancsok az interaktív munkamenet munkamenetparaméterét Enter-PSSession használják egy meglévő PowerShell-munkamenetben (PSSession).
4. példa: Interaktív munkamenet indítása és a port- és hitelesítő adatok paramétereinek megadása
PS> Enter-PSSession -ComputerName Server01 -Port 90 -Credential Domain01\User01
[Server01]: PS>Ez a parancs interaktív munkamenetet indít a Server01 számítógéppel. A Port paraméterrel adja meg a portot és a hitelesítőadat-paramétert annak a felhasználónak a fiókjának megadásához, aki engedéllyel rendelkezik a távoli számítógéphez való csatlakozáshoz.
5. példa: Interaktív munkamenet leállítása
PS> Enter-PSSession -ComputerName Server01
[Server01]: PS> Exit-PSSession
PS>Ez a példa bemutatja, hogyan indíthat el és állíthat le interaktív munkameneteket. Az első parancs a Enter-PSSession parancsmaggal indít egy interaktív munkamenetet a Server01 számítógéppel.
A második parancs a Exit-PSSession parancsmaggal fejezi be a munkamenetet. Az interaktív munkamenet befejezéséhez a Kilépés kulcsszót is használhatja. Exit-PSSession és a kilépésnek ugyanaz a hatása.
6. példa: Interaktív munkamenet indítása az SSH használatával
PS> Enter-PSSession -HostName UserA@LinuxServer01Ez a példa bemutatja, hogyan indíthat el interaktív munkamenetet a Secure Shell (SSH) használatával. Ha az SSH a távoli számítógépen jelszó használatára van konfigurálva, a rendszer kérni fogja, hogy adjon meg egy jelszót. Ellenkező esetben kulcsalapú felhasználói hitelesítést kell használnia.
7. példa: Interaktív munkamenet indítása SSH használatával port- és felhasználói hitelesítési kulccsal
PS> Enter-PSSession -HostName UserA@LinuxServer02:22 -KeyFilePath c:\sshkeys\userAKey_rsaEz a példa bemutatja, hogyan indíthat el interaktív munkamenetet az SSH használatával. A felhasználónév és az SSH-port száma a HostName paraméter értékének részeként van megadva. A KeyFilePath paraméter megadja a felhasználó távoli számítógépen való hitelesítéséhez használt RSA-kulcs helyét.
Paraméterek
-AllowRedirection
Lehetővé teszi a kapcsolat átirányítását egy alternatív egységes erőforrás-azonosítóra (URI). Alapértelmezés szerint az átirányítás nem engedélyezett.
A Csatlakozás ionURI 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 Maximális Csatlakozás ionRedirectionCount 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 beállításváltozó Maximum Csatlakozás ionRedirectionCount tulajdonságát$PSSessionOption. Az alapértelmezett érték 5.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ApplicationName
Megadja a kapcsolati URI alkalmazásnév-szegmensét. Ezzel a paraméterrel adhatja meg az alkalmazás nevét, ha nem használja a Csatlakozás ionURI paramétert a parancsban.
Az alapértelmezett érték a helyi számítógépen található $PSSessionApplicationName beállítási változó értéke. Ha ez a beállítási változó nincs definiálva, az alapértelmezett érték a WSMAN. Ez az érték a legtöbb felhasználáshoz megfelelő. További információ: about_Preference_Variables.
A WinRM szolgáltatás az alkalmazás nevével választ ki egy figyelőt a kapcsolatkérés kiszolgálásához. A paraméter értékének meg kell egyeznie a távoli számítógépen lévő figyelő URLPrefix tulajdonságának értékével.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Authentication
Megadja a felhasználó hitelesítő adatainak hitelesítéséhez használt mechanizmust. A paraméter elfogadható értékei a következők:
- Alapértelmezett
- Alap
- Credssp
- Digest
- Kerberos
- Tárgyalni
- NegotiateWithImplicitCredential
Az alapértelmezett érték az Alapértelmezett érték.
A CredSSP-hitelesítés csak a Windows Vista, a Windows Server 2008 és a Windows operációs rendszer újabb verzióiban érhető el.
A paraméter értékeivel kapcsolatos további információkért lásd : AuthenticationMechanism Enum.
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.
| Type: | AuthenticationMechanism |
| Accepted values: | Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CertificateThumbprint
Egy olyan felhasználói fiók digitális nyilvános kulcsú tanúsítványát (X509) adja meg, amely jogosult a művelet végrehajtására. 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 beszerzéséhez használja a Get-ItemGet-ChildItem PowerShell Cert: meghajtón található parancsot.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ComputerName
Megadja a számítógép nevét. Ez a parancsmag egy interaktív munkamenetet indít el a megadott távoli számítógéppel. Csak egy számítógépnevet adjon meg. Alapértelmezés szerint a helyi számítógép.
Írja be a netBIOS-nevet, az IP-címet vagy a számítógép teljes tartománynevét. A számítógép nevét a parancsra is be lehet csövezni Enter-PSSession.
Ha IP-címet szeretne használni a ComputerName paraméter értékében, a parancsnak tartalmaznia kell a hitelesítő adatot. Emellett a számítógépet HTTPS-átvitelre kell konfigurálni, vagy a távoli számítógép IP-címét fel kell venni a helyi számítógép WinRM TrustedHosts listájába. A számítógépnév TrustedHosts-listához való hozzáadására vonatkozó utasításokért tekintse meg a about_Remote_Troubleshooting "Számítógép hozzáadása a megbízható gazdagéplistához" című témakört.
Feljegyzés
A Windows operációs rendszeren ahhoz, hogy a helyi számítógép szerepeljen a ComputerName paraméter értékében, a PowerShellt a Futtatás rendszergazdaként beállítással kell elindítania.
| Type: | String |
| Aliases: | Cn |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ConfigurationName
Megadja az interaktív munkamenethez használt munkamenet-konfigurációt.
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.
Az SSH-val való használat esetén ez határozza meg a célon használni kívánt alrendszert a sshd_config. Az SSH alapértelmezett értéke az powershell alrendszer.
Egy munkamenet munkamenet-konfigurációja a távoli számítógépen található. Ha a megadott munkamenet-konfiguráció nem létezik a távoli számítógépen, a parancs meghiúsul.
Az alapértelmezett érték a helyi számítógépen található $PSSessionConfigurationName beállítási változó értéke. Ha ez a beállítási változó nincs beállítva, az alapértelmezett a Microsoft.PowerShell. További információ: about_Preference_Variables.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ConnectingTimeout
Ezredmásodpercben adja meg, hogy a kezdeti SSH-kapcsolat befejeződjön. Ha a kapcsolat nem fejeződik be a megadott időn belül, hibaüzenet jelenik meg.
Ez a paraméter a PowerShell 7.2-ben lett bevezetve
| Type: | Int32 |
| Position: | Named |
| Default value: | unlimited |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ConnectionUri
Egy URI-t ad meg, amely meghatározza a munkamenet kapcsolati végpontjait. 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 Csatlakozás ionURI-t, a UseSSL, a ComputerName, a Port és az ApplicationName paraméterekkel megadhatja a Csatlakozás ionURI-értékeket.
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 a következő szabványportok használatával 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 az 5985-ös portot a HTTP-hez, a HTTPS-hez pedig az 5986-os 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, hacsak nem használja az AllowRedirection paramétert a parancsban.
| Type: | Uri |
| Aliases: | URI, CU |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ContainerId
Egy tároló azonosítóját adja meg.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Credential
A művelet végrehajtásához engedéllyel rendelkező felhasználói fiókot ad meg. Alapértelmezés szerint az aktuális felhasználó.
Írjon be egy felhasználónevet (például User01 vagy Domain01\User01), vagy írjon be egy PSCredential objektumot, amelyet a Get-Credential parancsmag hoz létre. 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?.
| Type: | PSCredential |
| Position: | 1 |
| Default value: | Current user |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-EnableNetworkAccess
Azt jelzi, hogy ez a parancsmag egy interaktív biztonsági jogkivonatot ad hozzá a visszacsatolási munkamenetekhez. Az interaktív jogkivonat segítségével parancsokat futtathat a visszacsatolási munkamenetben, amelyek adatokat kapnak más számítógépekről. Futtathat például egy parancsot a munkamenetben, amely XML-fájlokat másol egy távoli számítógépről a helyi számítógépre.
A visszacsatolási munkamenet olyan PSSession , amely ugyanahhoz a számítógéphez kapcsolódik és végződik. Visszacsatolási munkamenet létrehozásához hagyja ki a ComputerName paramétert, vagy állítsa az értékét a következőre: . (pont), localhost vagy a helyi számítógép neve.
Alapértelmezés szerint a visszacsatolási munkamenetek hálózati jogkivonat használatával jönnek létre, ami nem feltétlenül biztosít elegendő engedélyt a távoli számítógépek hitelesítéséhez.
Az EnableNetworkAccess paraméter csak visszacsatolási munkamenetekben érvényes. Ha az EnableNetworkAccess szolgáltatást használja, amikor munkamenetet hoz létre egy távoli számítógépen, a parancs sikeres lesz, de a paraméter figyelmen kívül lesz hagyva.
A visszacsatolási munkamenetekben a távelérést a hitelesítési paraméter CredSSP értékével is engedélyezheti, amely a munkamenet hitelesítő adatait más számítógépekre delegálja.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-HostName
Megadja egy SSH-alapú kapcsolat számítógépnevét. Ez hasonló a ComputerName paraméterhez, azzal a kivétellel, hogy a távoli számítógéphez való kapcsolat A Windows WinRM helyett SSH használatával jön létre. Ez a paraméter támogatja a felhasználónév és/vagy port megadását az állomásnév paraméterértékének részeként az űrlap user@hostname:porthasználatával. A gazdagépnév részeként megadott felhasználónév és/vagy port elsőbbséget élvez a -UserName paraméterekkel szemben -Port , ha meg van adva. Ez lehetővé teszi több számítógépnév átadását ehhez a paraméterhez, ahol bizonyos felhasználónevek és/vagy portok vannak, míg mások a felhasználónevet és/vagy portot használják a paraméterekből és -Port a -UserName paraméterekből.
Ezt a paramétert a PowerShell 6.0-ban vezettük be.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Id
Egy meglévő munkamenet azonosítóját adja meg. Enter-PSSession A megadott munkamenetet használja az interaktív munkamenethez.
A munkamenet azonosítójának megkereséséhez használja a Get-PSSession parancsmagot.
| Type: | Int32 |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-InstanceId
Egy meglévő munkamenet példányazonosítóját adja meg. Enter-PSSession A megadott munkamenetet használja az interaktív munkamenethez.
A példányazonosító egy GUID. A munkamenet példányazonosítójának megkereséséhez használja a Get-PSSession parancsmagot. A munkamenet, a név vagy az azonosító paramétereit is használhatja egy meglévő munkamenet megadásához. Vagy a ComputerName paraméterrel is elindíthat egy ideiglenes munkamenetet.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-KeyFilePath
Megadja a Secure Shell (SSH) által a felhasználók távoli számítógépen történő hitelesítéséhez használt kulcsfájl elérési útját.
Az SSH lehetővé teszi, hogy a felhasználói hitelesítés privát/nyilvános kulcsokkal történjen az alapszintű jelszóhitelesítés alternatívájaként. Ha a távoli számítógép kulcshitelesítésre van konfigurálva, akkor ez a paraméter használható a felhasználót azonosító kulcs megadására.
Ezt a paramétert a PowerShell 6.0-ban vezettük be.
| Type: | String |
| Aliases: | IdentityFilePath |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Egy meglévő munkamenet rövid nevét adja meg. Enter-PSSession A megadott munkamenetet használja az interaktív munkamenethez.
Ha a megadott név egynél több munkamenetnek felel meg, a parancs meghiúsul. A munkamenet, az InstanceID vagy az ID paraméterek használatával is megadhat egy meglévő munkamenetet. Vagy a ComputerName paraméterrel is elindíthat egy ideiglenes munkamenetet.
Egy munkamenet rövid nevének létrehozásához használja a New-PSSession parancsmag Név paraméterét.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Port
A parancshoz használt hálózati portot adja meg a távoli számítógépen.
A PowerShell 6.0-ban ez a paraméter szerepel a HostName paraméterkészletben, amely támogatja az SSH-kapcsolatokat.
WinRM (ComputerName paraméterkészlet)
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 az 5985, amely a HTTP WinRM-portja, és az 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 használja az alábbi parancsokat:
winrm delete winrm/config/listener?Address=*+Transport=HTTPwinrm create winrm/config/listener?Address=*+Transport=HTTP @{Port="\<port-number\>"}
Csak akkor használja a Port paramétert, ha kötelező. A parancs portbeállítása minden 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.
SSH (HostName paraméterkészlet)
Távoli számítógéphez való csatlakozáshoz a távoli számítógépet az SSH szolgáltatással (SSHD) kell konfigurálni, és a kapcsolat által használt portot kell figyelnie. Az SSH alapértelmezett portja a 22.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsAdministrator
Azt jelzi, hogy a PSSession rendszergazdaként fut.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Session
Megadja az interaktív munkamenethez használni kívánt PowerShell-munkamenetet (PSSession). Ez a paraméter egy munkamenet-objektumot vesz igénybe. PsSession megadásához használhatja a Name, InstanceID vagy ID paramétereket is.
Adjon meg egy változót, amely egy munkamenet-objektumot vagy egy munkamenet-objektumot létrehozó vagy lekérő parancsot tartalmaz, például egy vagy Get-PSSession egy New-PSSession parancsot. A munkamenet-objektumot is becsúszthatja a parancsba Enter-PSSession. Ezzel a paraméterrel csak egy PSSession-t küldhet be. Ha egynél több PSSession-t tartalmazó változót ad meg, a parancs meghiúsul.
Amikor használja Exit-PSSession vagy az EXIT kulcsszót, az interaktív munkamenet véget ér, de a létrehozott PSSession nyitva marad, és használható marad.
| Type: | PSSession |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SessionOption
Speciális beállításokat ad meg a munkamenethez. 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.
A munkamenet beállításainak leírását, beleértve az alapértelmezett értékeket, tekintse meg a következőt New-PSSessionOption: .
A beállítási változóval kapcsolatos információkért $PSSessionOption 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.
| Type: | PSSessionOption |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SSHTransport
Azt jelzi, hogy a távoli kapcsolat a Secure Shell (SSH) használatával jön létre.
A PowerShell alapértelmezés szerint a Windows WinRM használatával csatlakozik egy távoli számítógéphez. Ez a kapcsoló arra kényszeríti a PowerShellt, hogy az SSH-alapú távoli kapcsolat létrehozásához használja a HostName paraméterkészletet.
Ezt a paramétert a PowerShell 6.0-ban vezettük be.
| Type: | SwitchParameter |
| Accepted values: | true |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Subsystem
Az új PSSession-hez használt SSH-alrendszert adja meg.
Ez határozza meg a célon a sshd_config definiált alrendszert. Az alrendszer előre definiált paraméterekkel elindítja a PowerShell egy adott verzióját. Ha a megadott alrendszer nem létezik a távoli számítógépen, a parancs meghiúsul.
Ha ezt a paramétert nem használja, az alapértelmezett a "powershell" alrendszer.
| Type: | String |
| Position: | Named |
| Default value: | Powershell |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-UserName
Megadja a távoli számítógépen munkamenet létrehozásához használt fiók felhasználónevet. A felhasználói hitelesítési módszer attól függ, hogy a Secure Shell (SSH) hogyan van konfigurálva a távoli számítógépen.
Ha az SSH alapszintű jelszó-hitelesítésre van konfigurálva, a rendszer kérni fogja a felhasználói jelszót.
Ha az SSH kulcsalapú felhasználói hitelesítésre van konfigurálva, akkor a KeyFilePath paraméterrel meg lehet adni egy kulcsfájl elérési útját, és nem történik jelszókérés. Vegye figyelembe, hogy ha az ügyfélfelhasználói kulcsfájl egy ismert SSH-helyen található, akkor a KeyFilePath paraméterre nincs szükség a kulcsalapú hitelesítéshez, és a felhasználói hitelesítés automatikusan megtörténik a felhasználónév alapján. További információt a kulcsalapú felhasználói hitelesítésről szóló SSH-dokumentációban talál.
Ez nem kötelező paraméter. Ha nincs megadva UserName paraméter, akkor a rendszer az aktuális bejelentkezési felhasználónevet használja a kapcsolathoz.
Ezt a paramétert a PowerShell 6.0-ban vezettük be.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseSSL
Azt jelzi, hogy ez a parancsmag a Secure Sockets Layer (SSL) protokoll használatával hoz létre kapcsolatot a távoli számítógéppel. 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMId
Egy virtuális gép azonosítóját adja meg.
| Type: | Guid |
| Aliases: | VMGuid |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMName
A virtuális gép nevét adja meg.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Bevitelek
A parancsmagra sztringként csövezheti a számítógép nevét.
Erre a parancsmagra egy munkamenet-objektumot csövezhet.
Kimenetek
None
Ez a parancsmag nem ad vissza kimenetet.
Jegyzetek
A PowerShell a következő aliasokat Enter-PSSessiontartalmazza:
- Minden platform:
etsn
Távoli számítógéphez való csatlakozáshoz a távoli számítógépen a Rendszergazda istrators csoport tagjának kell lennie. Ha interaktív munkamenetet szeretne indítani a helyi számítógépen, a PowerShellt a Futtatás rendszergazdaként beállítással kell elindítania.
Ha ezt használja Enter-PSSession, a rendszer a távoli számítógépen lévő felhasználói profilját használja az interaktív munkamenethez. A távoli felhasználói profil parancsai, beleértve a PowerShell-modulok hozzáadására és a parancssor módosítására vonatkozó parancsokat, futtassa a távoli kérés megjelenítése előtt.
Enter-PSSession az interaktív munkamenethez a helyi számítógépen található felhasználói felületi kultúrabeállítást használja. A helyi felhasználói felületi kultúra megkereséséhez használja az automatikus változót $UICulture .
Enter-PSSessionGet-Commanda , Out-Defaultés Exit-PSSession parancsmagokat igényli. Ha ezek a parancsmagok nem szerepelnek a távoli számítógépen futó munkamenet-konfigurációban, a Enter-PSSession parancsok meghiúsulnak.
Ellentétben Invoke-Commanda parancsokkal, amelyek értelmezik és elemzik a parancsokat, mielőtt elküldené őket a távoli számítógépre, Enter-PSSession a parancsokat közvetlenül a távoli számítógépre küldi értelmezés nélkül.
Ha a beírandó munkamenet egy parancs feldolgozása során foglalt, előfordulhat, hogy a PowerShell válaszol a Enter-PSSession parancsra. Amint a munkamenet elérhetővé válik, csatlakozik. A parancs megszakításához nyomja le a CTRL C billentyűkombinációt+.Enter-PSSession
A HostName paraméterkészlet a PowerShell 6.0-val kezdődően lett belefoglalva. Hozzá lett adva, hogy a Secure Shell (SSH) alapján biztosítsa a PowerShell-remotálást. Az SSH és a PowerShell is támogatott több platformon (Windows, Linux, macOS), és a PowerShell-remoting ezeken a platformokon működik, ahol a PowerShell és az SSH telepítve és konfigurálva van. Ez különbözik az előző Windows rendszertől, csak a WinRM-en alapuló újraegyezés, és a WinRM-specifikus funkciók és korlátozások nagy része nem érvényes. A WinRM-alapú kvóták, a munkamenet-beállítások, az egyéni végpontkonfiguráció és a leválasztási/újracsatlakozási funkciók jelenleg nem támogatottak. A PowerShell SSH-remoting beállításával kapcsolatos további információkért lásd : PowerShell Remoting Over SSH.
A PowerShell 7.1-et megelőzően az SSH-val való újraegyezés nem támogatja a másodlagos ugrásos távoli munkameneteket. Ez a képesség a WinRM-t használó munkamenetekre korlátozódott. A PowerShell 7.1 bármilyen interaktív távoli munkameneten belül lehetővé teszi Enter-PSSession és Enter-PSHostProcess használható.
Kapcsolódó hivatkozások
Visszajelzés
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ: https://aka.ms/ContentUserFeedback.
Visszajelzés küldése és megtekintése a következőhöz: