Enter-PSSession
Interaktív munkamenet indítása távoli számítógéppel.
Syntax
ComputerName (Alapértelmezett)
Enter-PSSession
[-ComputerName] <String>
[-EnableNetworkAccess]
[-Credential <PSCredential>]
[-Port <Int32>]
[-UseSSL]
[-ConfigurationName <String>]
[-ApplicationName <String>]
[-SessionOption <PSSessionOption>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[<CommonParameters>]
Session
Enter-PSSession
[[-Session] <PSSession>]
[<CommonParameters>]
Uri
Enter-PSSession
[[-ConnectionUri] <Uri>]
[-EnableNetworkAccess]
[-Credential <PSCredential>]
[-ConfigurationName <String>]
[-AllowRedirection]
[-SessionOption <PSSessionOption>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[<CommonParameters>]
InstanceId
Enter-PSSession
[-InstanceId <Guid>]
[<CommonParameters>]
Id
Enter-PSSession
[[-Id] <Int32>]
[<CommonParameters>]
Name
Enter-PSSession
[-Name <String>]
[<CommonParameters>]
VMId
Enter-PSSession
[-VMGuid] <Guid>
-Credential <PSCredential>
[<CommonParameters>]
VMName
Enter-PSSession
[-VMName] <String>
-Credential <PSCredential>
[<CommonParameters>]
Description
Az 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.
A távoli számítógép nevének megadásához általában a ComputerName paramétert használja. Használhat azonban olyan munkamenetet is, amelyet az interaktív munkamenethez tartozó New-PSSession parancsmaggal hozhat létre. A Disconnect-PSSession, a Connect-PSSession vagy a Receive-PSSession parancsmagok azonban nem használhatók az interaktív munkamenetek leválasztásához vagy újracsatlakozásához.
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 Exit-PSSession parancsmagot, vagy írja be a exit.
Példák
1. példa: Interaktív munkamenet indítása
PS C:\> Enter-PSSession
[localhost]: PS C:\>
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
The first command uses the **Enter-PSSession** cmdlet to start an interactive session with Server01, a remote computer. When the session starts, the command prompt changes to include the computer name.
PS C:\> Enter-PSSession -ComputerName Server01
[Server01]: PS C:\>
The second command gets the Windows PowerShell process and redirects the output to the Process.txt file. The command is submitted to the remote computer, and the file is saved on the remote computer.
[Server01]: PS C:\> Get-Process PowerShell > C:\ps-test\Process.txt
The third command uses the **Exit** keyword to end the interactive session and close the connection.
[Server01]: PS C:\> exit
PS C:\>
The fourth command confirms that the Process.txt file is on the remote computer. A **Get-ChildItem** ("dir") command on the local computer cannot find the file.
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 C:\> $s = New-PSSession -ComputerName Server01
PS C:\> Enter-PSSession -Session $s
[Server01]: PS C:\>
Ezek a parancsok az Enter-PSSessionMunkamenet paraméterével futtatják az interaktív munkamenetet egy meglévő Windows PowerShell-munkamenetben (PSSession).
4. példa: Interaktív munkamenet indítása és a port- és hitelesítő adatok paramétereinek megadása
PS C:\> Enter-PSSession -ComputerName Server01 -Port 90 -Credential Domain01\User01
[Server01]: PS C:\>
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ő adatok paramétert annak a felhasználónak a fiókjának megadásához, aki jogosult csatlakozni a távoli számítógéphez.
5. példa: Interaktív munkamenet leállítása
PS C:\> Enter-PSSession -ComputerName Server01
[Server01]: PS C:\> Exit-PSSession
PS C:\>
Ez a példa bemutatja, hogyan indíthat el és állíthat le interaktív munkameneteket. Az első parancs az Enter-PSSession parancsmaggal indít interaktív munkamenetet a Server01 számítógéppel.
A második parancs a Exit-PSSession parancsmagot használja a munkamenet befejezéséhez. Az interaktív munkamenet befejezéséhez használhatja a Kilépés kulcsszót is. Exit-PSSession és Exit ugyanazzal a hatással rendelkezik.
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.
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 Windows 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 New-PSSessionOption parancsmag MaximumRedirection paraméterét, vagy állítsa be a $PSSessionOption beállítási változó MaximumConnectionRedirectionCount tulajdonságát. Az alapértelmezett érték 5.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
Uri
| 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
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 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.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
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 felhasználó hitelesítő adatainak hitelesítéséhez használt mechanizmust. A paraméter elfogadható értékei a következők:
- Alapértelmezett
- Alapszintű
- Credssp
- Összefoglaló
- Kerberos
- Tárgyal
- Tárgyalás Beágyazott Hitelesítő Adattal
Az alapértelmezett érték az Alapértelmezett.
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 tekintse meg AuthenticationMechanism Enumeration az MSDN-kódtárban.
Figyelem: 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
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 |
Uri
| 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
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 Windows PowerShell Cert: meghajtó Get-Item vagy Get-ChildItem parancsát.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
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 |
Uri
| 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 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. Az alapértelmezett beállítás 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 az Enter-PSSession
Ha IP-címet szeretne használni a ComputerName paraméter értékében, a parancsnak tartalmaznia kell a Hitelesítő adatok paramétert. 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 lásd a "Számítógép hozzáadása a megbízható gazdagéplistához" című témakört about_Remote_Troubleshooting.
Megjegyzés: A Windows Vista és a Windows operációs rendszer újabb verzióiban ahhoz, hogy a helyi számítógép szerepeljen a ComputerName paraméter értékében, a Windows PowerShellt a Futtatás rendszergazdaként beállítással kell elindítania.
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
ComputerName
| 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 |
-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 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: https://schemas.microsoft.com/powershell.
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.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
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 |
Uri
| 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
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ő:
https://localhost:5985/WSMAN
Ha nem ad meg ConnectionURI, a UseSSL, ComputerName, Portés ApplicationName paramétereket használhatja a ConnectionURI értékek megadásához.
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 Windows PowerShell-remoting 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 Windows 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
Uri
| Position: | 1 |
| 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 |
-Credential
A művelet végrehajtásához engedéllyel rendelkező felhasználói fiókot ad meg. Az alapértelmezett az aktuális felhasználó.
Írjon be egy felhasználónevet, például User01, Domain01\User01vagy User@Domain.com, vagy írjon be egy PSCredential objektumot, például a Get-Credential parancsmag által visszaadott objektumot.
Felhasználónév beírásakor ez a parancsmag jelszó megadását kéri.
Paramétertulajdonságok
| Típus: | PSCredential |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
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 |
Uri
| 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 |
VMId
| Position: | Named |
| 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 |
VMName
| Position: | Named |
| 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 |
-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 egy PSSession, amely ugyanabból a számítógépről származik é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 EnableNetworkAccess használ, 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.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
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 |
Uri
| 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
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.
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ő: | 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 |
-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-, Névvagy azonosító paramétereket is használhatja egy meglévő munkamenet megadásához. Vagy a ComputerName paraméterrel is elindíthat egy ideiglenes munkamenetet.
Paramétertulajdonságok
| Típus: | Guid |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
InstanceId
| 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 |
-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-, InstanceIDvagy azonosító paramétereket is használhatja egy meglévő munkamenet megadásához. 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.
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ő: | 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 |
-Port
A parancshoz használt hálózati portot adja meg a távoli számítógépen. 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:
1. winrm delete winrm/config/listener?Address=*+Transport=HTTP
2. winrm create winrm/config/listener?Address=*+Transport=HTTP @{Port="\<port-number\>"}
Ne használja a Port paramétert, hacsak nem szükséges. 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.
Paramétertulajdonságok
| Típus: | Int32 |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
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
Az interaktív munkamenethez használandó Windows PowerShell-munkamenetet (PSSession) adja meg. Ez a paraméter egy munkamenet-objektumot vesz igénybe. A Név, InstanceIDvagy azonosító paraméterek használatával is megadhat PSSession.
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 New-PSSession vagy Get-PSSession parancsot.
A munkamenet-objektumokat az Enter-PSSession
Ha Exit-PSSession vagy az EXIT kulcsszót használja, az interaktív munkamenet véget ér, de a létrehozott PSSession továbbra is nyitva marad és használható marad.
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ő: | False |
| 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
Speciális beállításokat ad meg a munkamenethez. Adjon meg egy SessionOption objektumot, például az 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 az $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.
A munkamenet beállításainak leírását, beleértve az alapértelmezett értékeket, tekintse meg 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
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 |
Uri
| 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) 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.
WS-Management titkosítja a hálózaton keresztül továbbított összes Windows 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
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 |
-VMGuid
Egy virtuális gép azonosítóját adja meg.
Paramétertulajdonságok
| Típus: | Guid |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
VMId
| 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 |
-VMName
A virtuális gép nevét adja meg.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
VMName
| 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 |
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
System.String, System.Management.Automation.Runspaces.PSSession
A parancsmaghoz sztringként vagy munkamenet-objektumként csövezheti a számítógép nevét.
Kimenetek
None
A parancsmag nem ad vissza kimenetet.
Jegyzetek
- 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.
- A Windows Vista és a Windows operációs rendszer újabb verzióiban az interaktív munkamenet helyi számítógépen való elindításához a Windows PowerShellt a Futtatás rendszergazdaként lehetőséggel kell elindítania.
- Az Enter-PSSessionhasználatakor a rendszer a távoli számítógépen lévő felhasználói profilt használja az interaktív munkamenethez. A távoli felhasználói profilban található parancsok, beleértve a Windows PowerShell beépülő 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 a felhasználói felület kulturális beállításait használja a helyi számítógépen az interaktív munkamenethez. A helyi felhasználói felületi kultúra megkereséséhez használja az $UICulture automatikus változót.
- Enter-PSSession get-command, out-default és Exit-PSSession parancsmagokat igényel. Ha ezek a parancsmagok nem szerepelnek a távoli számítógépen a munkamenet-konfigurációban, a Enter-PSSession parancsok meghiúsulnak.
- Ellentétben az Invoke-Command paranccsal, amely elemzi és értelmezi a parancsokat, mielőtt elküldi őket a távoli számítógépre, Enter-PSSession közvetlenül a távoli számítógépre küldi a parancsokat értelmezés nélkül.
- Ha az beírandó munkamenet egy parancs feldolgozása során foglalt, előfordulhat, hogy a Windows PowerShell válaszol az Enter-PSSession parancsra. Amint a munkamenet elérhető, csatlakozni fog. A Enter-PSSession parancs megszakításához nyomja le a
CTRL+C.