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>
[-Options <Hashtable>]
[-Port <Int32>]
[-UserName <String>]
[-KeyFilePath <String>]
[-Subsystem <String>]
[-ConnectingTimeout <Int32>]
[-SSHTransport]
[<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ához vagy Receive-PSSession
újbóli csatlakozásához azonban nem használhatja a Disconnect-PSSession
parancsmagokat Connect-PSSession
vagy parancsmagokat.
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. A helyi számítógépen SSH-val kell rendelkeznie, a távoli számítógépet pedig PowerShell SSH-végponttal kell konfigurálni. 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
.
Fontos
Enter-PSSession
úgy lett kialakítva, hogy az aktuális interaktív munkamenetet egy új interaktív távoli munkamenettel helyettesítse. Nem szabad függvényen vagy szkripten belülről meghívni, vagy parancsként átadni a pwsh
végrehajthatónak.
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.txt
Ez 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@LinuxServer01
Ez 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_rsa
Ez 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.
8. példa: Interaktív munkamenet indítása SSH-beállításokkal
$options = @{
Port=22
User = 'UserA'
Host = 'LinuxServer02'
}
Enter-PSSession -KeyFilePath c:\sshkeys\userAKey_rsa -Options $options
Ez a példa bemutatja, hogyan indíthat el interaktív munkamenetet az SSH használatával. A Beállítások paraméter azokat az értékeket kivonatolhatja, amelyeket a rendszer a távoli rendszerrel létesített kapcsolat létesített alapjául szolgáló ssh
parancsnak ad át beállításokként.
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 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ét New-PSSessionOption
, vagy állítsa be a beállításváltozó MaximumConnectionRedirectionCount tulajdonságát $PSSessionOption
. Az alapértelmezett érték 5.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | False |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-ApplicationName
Megadja a kapcsolati URI alkalmazásnév-szegmensét. Ezzel a paraméterrel megadhatja az alkalmazás nevét, ha nem használja a ConnectionURI 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.
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 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
- Emészt
- Kerberos
- Tárgyal
- 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.
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
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-Item
Get-ChildItem
PowerShell Cert: meghajtón található parancsot.
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 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.
Típus: | String |
Aliasok: | Cn |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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
Típus: | Int32 |
Position: | Named |
Alapértelmezett érték: | unlimited |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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 ConnectionURI-t, a ConnectionURI-értékek megadásához használhatja a UseSSL, a ComputerName, a Port és az ApplicationName paramétereket.
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.
Típus: | Uri |
Aliasok: | URI, CU |
Position: | 1 |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-ContainerId
Egy tároló azonosítóját adja meg.
Típus: | String |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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?.
Típus: | PSCredential |
Position: | 1 |
Alapértelmezett érték: | Current user |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | False |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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:port
haszná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.
Típus: | String |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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.
Típus: | Int32 |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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.
Típus: | Guid |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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.
Típus: | String |
Aliasok: | IdentityFilePath |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-Options
A távoli SSH-alapú munkamenethez való csatlakozáskor használt SSH-beállítások kivonatát adja meg. A lehetséges lehetőségek az ssh-parancs Unix-alapú verziója által támogatott értékek.
A paraméterek által explicit módon átadott értékek elsőbbséget élveznek a Beállítások kivonatolóban átadott értékekkel szemben. A Port paraméterrel például felülbírálhatja Port
a Beállítások kivonatolóban átadott kulcs-érték párokat.
Típus: | Hashtable |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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=HTTP
winrm 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.
Típus: | Int32 |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-RunAsAdministrator
Azt jelzi, hogy a PSSession rendszergazdaként fut.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | False |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | PSSession |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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 $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 beállításváltozóban és a $PSSessionOption
munkamenet-konfigurációban beállított munkamenetek alapértelmezett értékeivel szemben. Azonban nem élveznek elsőbbséget 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.
Típus: | PSSessionOption |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | SwitchParameter |
Elfogadott értékek: | true |
Position: | Named |
Alapértelmezett érték: | False |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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 az powershell
alrendszer.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | Powershell |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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éri a felhasználói jelszót.
Ha az SSH kulcsalapú felhasználói hitelesítésre van konfigurálva, akkor a rendszer nem kéri a jelszót. Meg kell adnia egy SSH-kulcsfájl elérési útját. Ha a felhasználói kulcsfájl egy ismert SSH-helyen található, akkor nincs szükség a KeyFilePath paraméterre. A felhasználói hitelesítés automatikusan tö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.
Ha a UserName paraméter nincs megadva, akkor a rendszer az aktuális bejelentkezett felhasználónevet használja.
Ezt a paramétert a PowerShell 6.0-ban vezettük be.
Típus: | String |
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) 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.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | False |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-VMId
Egy virtuális gép azonosítóját adja meg.
Típus: | Guid |
Aliasok: | VMGuid |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-VMName
A virtuális gép nevét adja meg.
Típus: | String |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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-PSSession
tartalmazza:
- Minden platform:
etsn
Távoli számítógéphez való csatlakozáshoz a távoli számítógépen a Rendszergazdák 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-PSSession
Get-Command
a , 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-Command
a 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ő Windowstól, csak a WinRM-en alapuló átnevezé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-ra való átnevezés nem támogatja a második 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ó.
A ssh
végrehajtható a következő forrásokból szerzi be a konfigurációs adatokat a következő sorrendben:
- parancssori beállítások
- felhasználó konfigurációs fájlja (~/.ssh/config)
- rendszerszintű konfigurációs fájl (/etc/ssh/ssh_config)
A következő parancsmagparaméterek lesznek leképezve a paraméterekre és a beállításokra ssh
:
Parancsmag paramétere | ssh paraméter | egyenértékű ssh -o lehetőség |
---|---|---|
-KeyFilePath |
-i <KeyFilePath> |
-o IdentityFile=<KeyFilePath> |
-UserName |
-l <UserName> |
-o User=<UserName> |
-Port |
-p <Port> |
-o Port=<Port> |
-ComputerName -Subsystem |
-s <ComputerName> <Subsystem> |
-o Host=<ComputerName> |
A paraméterek által explicit módon átadott értékek elsőbbséget élveznek a Beállítások kivonatolóban átadott értékekkel szemben. További információ a fájlokról ssh_config
: ssh_config(5).