New-PSSession
Állandó kapcsolatot hoz létre egy helyi vagy távoli számítógéppel.
Syntax
ComputerName (Alapértelmezett)
New-PSSession
[[-ComputerName] <String[]>]
[-Credential <PSCredential>]
[-Name <String[]>]
[-EnableNetworkAccess]
[-ConfigurationName <String>]
[-Port <Int32>]
[-UseSSL]
[-ApplicationName <String>]
[-ThrottleLimit <Int32>]
[-SessionOption <PSSessionOption>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[<CommonParameters>]
Uri
New-PSSession
[-ConnectionUri] <Uri[]>
[-Credential <PSCredential>]
[-Name <String[]>]
[-EnableNetworkAccess]
[-ConfigurationName <String>]
[-ThrottleLimit <Int32>]
[-AllowRedirection]
[-SessionOption <PSSessionOption>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[<CommonParameters>]
VMId
New-PSSession
[-VMId] <Guid[]>
-Credential <PSCredential>
[-Name <String[]>]
[-ConfigurationName <String>]
[-ThrottleLimit <Int32>]
[<CommonParameters>]
VMName
New-PSSession
-Credential <PSCredential>
-VMName <String[]>
[-Name <String[]>]
[-ConfigurationName <String>]
[-ThrottleLimit <Int32>]
[<CommonParameters>]
Session
New-PSSession
[[-Session] <PSSession[]>]
[-Name <String[]>]
[-EnableNetworkAccess]
[-ThrottleLimit <Int32>]
[<CommonParameters>]
ContainerId
New-PSSession
-ContainerId <String[]>
[-Name <String[]>]
[-ConfigurationName <String>]
[-RunAsAdministrator]
[-ThrottleLimit <Int32>]
[<CommonParameters>]
UseWindowsPowerShellParameterSet
New-PSSession
[-Name <String[]>]
[-UseWindowsPowerShell]
[<CommonParameters>]
SSHHost
New-PSSession
[-HostName] <String[]>
[-Name <String[]>]
[-Port <Int32>]
[-UserName <String>]
[-KeyFilePath <String>]
[-Subsystem <String>]
[-ConnectingTimeout <Int32>]
[-SSHTransport]
[-Options <Hashtable>]
[<CommonParameters>]
SSHHostHashParam
New-PSSession
-SSHConnection <Hashtable[]>
[-Name <String[]>]
[<CommonParameters>]
Description
A New-PSSession parancsmag létrehoz egy PowerShell-munkamenetet (PSSession) helyi vagy távoli számítógépen. Amikor létrehoz egy PSSession, a PowerShell állandó kapcsolatot létesít a távoli számítógéppel.
Egy PSSession használatával több olyan parancsot futtathat, amelyek adatokat osztanak meg, például egy függvényt vagy egy változó értékét. Ha parancsokat szeretne futtatni egy PSSession, használja a Invoke-Command parancsmagot. A PSSession távoli számítógéppel való közvetlen interakcióhoz használja a Enter-PSSession parancsmagot. További információ: about_PSSessions.
Parancsokat futtathat távoli számítógépen anélkül, hogy létrehozna egy PSSession a ComputerName paraméterrel Enter-PSSession vagy Invoke-Command. A ComputerName paraméter használatakor a PowerShell létrehoz egy ideiglenes kapcsolatot, amely a parancshoz lesz használva, majd bezárul.
A PowerShell 6.0-tól kezdve a Secure Shell (SSH) használatával létesíthet kapcsolatot és hozhat létre munkamenetet egy távoli számítógépen, 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) is használható. SSH-alapú munkamenetek esetén az HostName vagy SSHConnection paraméterkészlettel adhatja 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 SSHcímű témakört.
Megjegyzés:
Ha olyan Linux- vagy macOS-ügyfélről használ WSMan-remotingot, amely https-végponttal rendelkezik, ahol a kiszolgálótanúsítvány nem megbízható (például önaláírt tanúsítvány). Meg kell adnia egy PSSessionOption, amely tartalmazza a SkipCACheck és SkipCNCheck értékeket $true a kapcsolat sikeres létrehozásához. Ezt csak akkor tegye, ha olyan környezetben van, ahol biztos lehet a kiszolgálótanúsítványban és a célrendszerhez való hálózati kapcsolatban.
Példák
1. példa: Munkamenet létrehozása a helyi számítógépen
$s = New-PSSession
Ez a parancs létrehoz egy új PSSession a helyi számítógépen, és menti a PSSession a $s változóba.
Most már használhatja ezt a PSSession parancsok futtatásához a helyi számítógépen.
2. példa: Munkamenet létrehozása távoli számítógépen
$Server01 = New-PSSession -ComputerName Server01
Ez a parancs létrehoz egy új PSSession a Server01 számítógépen, és menti a $Server01 változóba.
Ha több PSSession objektumot hoz létre, rendelje hozzá őket hasznos névvel rendelkező változókhoz. Ez segít kezelni a PSSession objektumokat a következő parancsokban.
3. példa: Munkamenetek létrehozása több számítógépen
$s1, $s2, $s3 = New-PSSession -ComputerName Server01, Server02, Server03
Ez a parancs három PSSession objektumot hoz létre, egyet a ComputerName paraméter által megadott számítógépeken.
A parancs a hozzárendelési operátor (=) használatával rendeli hozzá az új PSSession objektumokat változókhoz: $s1, $s2, $s3. Hozzárendeli a Server01 PSSession$s1, a Server02 PSSession a $s2, a Server03 PSSession pedig $s3.
Ha több objektumot rendel egy változósorozathoz, a PowerShell az egyes objektumokat az adatsor egy változóhoz rendeli. Ha több objektum van, mint változó, a rendszer az összes többi objektumot az utolsó változóhoz rendeli hozzá. Ha az objektumoknál több változó van, a fennmaradó változók üresek ($null).
4. példa: Munkamenet létrehozása megadott porttal
New-PSSession -ComputerName Server01 -Port 8081 -UseSSL -ConfigurationName E12
Ez a parancs létrehoz egy új PSSession a Server01 számítógépen, amely csatlakozik a kiszolgálóporthoz 8081 és az SSL protokollt használja. Az új PSSession egy E12nevű alternatív munkamenet-konfigurációt használ.
A port beállítása előtt konfigurálnia kell a WinRM-figyelőt a távoli számítógépen a 8081-s port figyelésére. További információ: Port paraméter leírása.
5. példa: Munkamenet létrehozása meglévő munkamenet alapján
New-PSSession -Session $s -Credential Domain01\User01
Ez a parancs létrehoz egy PSSession ugyanazokkal a tulajdonságokkal, mint egy meglévő PSSession. Ezt a parancsformátumot akkor használhatja, ha egy meglévő PSSession erőforrásai kimerülnek, és új PSSession van szükség az igények egy részének kiszervezéséhez.
A parancs a New-PSSession paraméterével adja meg a változóban mentett $s. A parancs végrehajtásához a Domain1\Admin01 felhasználó hitelesítő adatait használja.
6. példa: Munkamenet létrehozása globális hatókörrel egy másik tartományban
$Global:s = New-PSSession -ComputerName Server1.Domain44.Corpnet.Fabrikam.com -Credential Domain01\Admin01
Ez a példa bemutatja, hogyan hozhat létre egy PSSession globális hatókörrel egy másik tartományban lévő számítógépen.
Alapértelmezés szerint a parancssorban létrehozott PSSession objektumok helyi hatókörrel jönnek létre, és szkriptben létrehozott PSSession objektumok szkript hatókörrel rendelkeznek.
Ha globális hatókörrel rendelkező PSSession szeretne létrehozni, hozzon létre egy új PSSession, majd tárolja a PSSession egy globális hatókörbe leadott változóban. Ebben az esetben a $s változó globális hatókörbe kerül.
A parancs a ComputerName paramétert használja a távoli számítógép megadásához. Mivel a számítógép más tartományban van, mint a felhasználói fiók, a számítógép teljes neve a felhasználó hitelesítő adataival együtt van megadva.
7. példa: Munkamenetek létrehozása számos számítógéphez
$rs = Get-Content C:\Test\Servers.txt | New-PSSession -ThrottleLimit 50
Ez a parancs létrehoz egy PSSession a Servers.txt fájlban felsorolt 200 számítógépen, és az eredményül kapott PSSession tárolja a $rs változóban. Az PSSession objektumok szabályozható korlátja 50.
Ezt a parancsformátumot akkor használhatja, ha a számítógépek neve adatbázisban, számolótáblában, szövegfájlban vagy más szövegkonvertáló formátumban van tárolva.
8. példa: Munkamenet létrehozása URI használatával
$s = New-PSSession -Uri http://Server01:91/NewSession -Credential Domain01\User01
Ez a parancs létrehoz egy PSSession a Server01 számítógépen, és a $s változóban tárolja. A URI paramétert használja az átviteli protokoll, a távoli számítógép, a port és egy alternatív munkamenet-konfiguráció megadásához. Emellett a Hitelesítő adatok paramétert használja egy olyan felhasználói fiók megadásához, amely jogosult munkamenet létrehozására a távoli számítógépen.
9. példa: Háttérfeladat futtatása munkamenetek halmazában
$s = New-PSSession -ComputerName (Get-Content Servers.txt) -Credential Domain01\Admin01 -ThrottleLimit 16
Invoke-Command -Session $s -ScriptBlock {Get-Process powershell} -AsJob
Ezek a parancsok létrehoznak egy PSSession objektumokat, majd futtatnak egy háttérfeladatot az egyes PSSession objektumokban.
Az első parancs létrehoz egy új PSSession az Servers.txt fájlban felsorolt számítógépeken. A New-PSSession parancsmaggal hozza létre a PSSession. A ComputerName paraméter értéke egy olyan parancs, amely a Get-Content parancsmagot használja a Servers.txt fájl számítógépneveinek listájának lekéréséhez.
A parancs a Hitelesítő adatok paraméterrel hozza létre a PSSession objektumokat, amelyek rendelkeznek tartományi rendszergazda engedélyével, és a ThrottleLimit paraméterrel korlátozza a parancsot az egyidejű kapcsolatok 16. A parancs menti a PSSession objektumokat a $s változóban.
A második parancs a parancsmag Invoke-Command paraméterével indít el egy háttérfeladatot, amely Get-Process powershell parancsot futtat a $s objektumaiban.
További információ a PowerShell háttérfeladatairól: about_Jobs és about_Remote_Jobs.
10. példa: Munkamenet létrehozása számítógéphez az URI használatával
New-PSSession -ConnectionURI https://management.exchangelabs.com/Management
Ez a parancs létrehoz egy PSSession objektumot, amely számítógépnév helyett egy URI által megadott számítógéphez csatlakozik.
11. példa: Munkamenet-beállítás létrehozása
$so = New-PSSessionOption -SkipCACheck
New-PSSession -ConnectionUri https://management.exchangelabs.com/Management -SessionOption $so -Credential Server01\Admin01
Ez a példa bemutatja, hogyan hozhat létre munkamenet-beállításobjektumot, és hogyan használhatja a SessionOption paramétert.
Az első parancs a New-PSSessionOption parancsmaggal hoz létre munkamenet-beállítást. Menti az eredményül kapott SessionOption objektumot a $so változóban.
A második parancs egy új munkamenetben használja a lehetőséget. A parancs a New-PSSession parancsmaggal hoz létre egy új munkamenetet. A SessionOption paraméter értéke a változó $so objektuma.
12. példa: Munkamenet létrehozása SSH használatával
New-PSSession -HostName UserA@LinuxServer01
Ez a példa bemutatja, hogyan hozhat létre új PSSession a Secure Shell (SSH) használatával. Ha az SSH úgy van konfigurálva a távoli számítógépen, hogy jelszavakat kérjen, egy jelszókérést fog kapni. Ellenkező esetben SSH-kulcsalapú felhasználói hitelesítést kell használnia.
13. példa: Munkamenet létrehozása SSH használatával, és a port és a felhasználó hitelesítési kulcsának megadása
New-PSSession -HostName UserA@LinuxServer01:22 -KeyFilePath C:\<path>\userAKey_rsa
Ez a példa bemutatja, hogyan hozhat létre PSSession a Secure Shell (SSH) használatával. A Port paraméter használatával adja meg a használni kívánt portot, a KeyFilePath paraméter pedig egy RSA-kulcsot, amellyel azonosíthatja és hitelesítheti a felhasználót a távoli számítógépen.
14. példa: Több munkamenet létrehozása SSH használatával
$sshConnections = @(
@{
HostName = 'WinServer1'
UserName = 'domain\userA'
KeyFilePath = 'C:\Users\UserA\id_rsa'
}
@{
HostName = 'UserB@LinuxServer5'
KeyFilePath = 'C:\UserB\<path>\id_rsa'
}
)
New-PSSession -SSHConnection $sshConnections
Ez a példa bemutatja, hogyan hozhat létre több munkamenetet a Secure Shell (SSH) és a SSHConnection paraméterkészlet használatával. Az SSHConnection paraméter kivonattáblák tömbjét veszi fel, amelyek kapcsolati adatokat tartalmaznak az egyes munkamenetekhez. Vegye figyelembe, hogy ez a példa megköveteli, hogy a cél távoli számítógépek SSH-t konfigurálva támogassák a kulcsalapú felhasználói hitelesítést.
15. példa: Új munkamenet létrehozása SSH-beállítások használatával
$options = @{
Port=22
User = 'UserB'
Host = 'LinuxServer5'
}
New-PSSession -KeyFilePath '/Users/UserB/id_rsa' -Options $options
Ez a példa bemutatja, hogyan hozhat létre egy új SSH-alapú munkamenetet távoli Linux-alapú gépként SSH-beállítások használatával. A Beállítások paraméter az alapul szolgáló ssh parancsnak átadott értékek kivonatát veszi át a távoli rendszerrel való kapcsolat létesítése érdekében.
Paraméterek
-AllowRedirection
Azt jelzi, hogy ez a parancsmag lehetővé teszi a kapcsolat átirányítását egy alternatív egységes erőforrás-azonosítóra (URI).
Ha a ConnectionURI paramétert használja, a távoli cél egy utasítást adhat vissza egy másik URI-ra való átirányításhoz. A PowerShell alapértelmezés szerint nem irányítja át a kapcsolatokat, de ezzel a paramétersel engedélyezheti a kapcsolat átirányítását.
A MaximumConnectionRedirectionCount munkamenetbeállítás értékének módosításával azt is korlátozhatja, hogy a rendszer hányszor irányítsa át a kapcsolatot. Használja a parancsmag New-PSSessionOption paraméterét, vagy állítsa be a $PSSessionOption beállítási változó MaximumConnectionRedirectionCount tulajdonságát. Az alapértelmezett érték a 5.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| 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ásváltozó nincs definiálva, az alapértelmezett érték WSMAN. Ez az érték a legtöbb felhasználáshoz megfelelő. További információ a about_Preference_Variablescímű részben található.
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:
DefaultBasicCredsspDigestKerberosNegotiateNegotiateWithImplicitCredential
Az alapértelmezett érték a Default.
A paraméter értékeivel kapcsolatos további információkért lásd AuthenticationMechanism Enumeration.
Figyelmeztetés
A hitelesítő adatok biztonsági támogatási szolgáltatójának (CredSSP) hitelesítése, amelyben a felhasználói hitelesítő adatok á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 PowerShell-Get-Item meghajtó Get-ChildItem vagy Cert: 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épek neveit tartalmazó tömböt. Ez a parancsmag állandó kapcsolatot (PSSession) hoz létre a megadott számítógéppel. Ha több számítógépnevet ad meg, New-PSSession több PSSession objektumot hoz létre, egyet minden számítógéphez. Az alapértelmezett beállítás a helyi számítógép.
Írja be egy vagy több távoli számítógép NetBIOS-nevét, IP-címét vagy teljes tartománynevét. A helyi számítógép megadásához írja be a számítógép nevét, localhostvagy pont (.). Ha a számítógép más tartományban van, mint a felhasználó, a teljes tartománynévre van szükség.
A számítógép nevét idézőjelek között is becsúszthatja a New-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 tekintse meg a "Számítógép hozzáadása a megbízható gazdagéplistához" című témakört about_Remote_Troubleshooting.
Ha a helyi számítógépet fel szeretné venni a ComputerName paraméter értékére, indítsa el a Windows PowerShellt a Futtatás rendszergazdaként beállítással.
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ő: | 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 |
-ConfigurationName
Megadja az új PSSessionhaszná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: http://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 érték Microsoft.PowerShell. További információ a about_Preference_Variablescímű részben található.
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 |
VMId
| 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 |
VMName
| 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 |
ContainerId
| 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 |
-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
Paramétertulajdonságok
| Típus: | Int32 |
| Alapértelmezett érték: | unlimited |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
SSHHost
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-ConnectionUri
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, 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 szabványportokkal jön létre: http-hez 80 és HTTPS-443. A PowerShell-újraküldés alapértelmezett portjának használatához adja meg a HTTP-hez 5985 vagy a HTTPS-5986 portot.
Ha a célszámítógép átirányítja a kapcsolatot egy másik URI-ra, a PowerShell megakadályozza az átirányítást, kivéve, ha a parancsban az AllowRedirection paramétert használja.
Paramétertulajdonságok
| Típus: | Uri[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | URI, CU |
Paraméterkészletek
Uri
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-ContainerId
Tárolók azonosítóinak tömbje. Ez a parancsmag egy interaktív munkamenetet indít el a megadott tárolókkal. A tárolóazonosítók listájának lekéréséhez használja a docker ps parancsot. További információt a docker ps parancs súgójában talál.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
ContainerId
| 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 |
-Credential
Olyan felhasználói fiókot ad meg, amely rendelkezik a művelet végrehajtásához engedéllyel. Az alapértelmezett az aktuális felhasználó.
Írjon be egy felhasználónevet, például User01 vagy Domain01\User01, vagy adjon meg 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 egy PSCredential objektum tárolja, a jelszó pedig SecureString.
Megjegyzés:
További információért a SecureString adatvédelemről lásd: Mennyire biztonságos a SecureString?.
Paramétertulajdonságok
| Típus: | PSCredential |
| Alapértelmezett érték: | Current user |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
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 pont (.), localhostvagy a helyi számítógép nevére.
Ez a parancsmag alapértelmezés szerint egy hálózati jogkivonat használatával hozza létre a visszacsatolási munkameneteket, 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 CredSSP paraméter értékével is engedélyezheti, amely a munkamenet hitelesítő adatait más számítógépekre delegálja.
A számítógép rosszindulatú hozzáférés elleni védelme érdekében az interaktív jogkivonatokkal rendelkező leválasztott visszacsatolási munkamenetek, amelyek az EnableNetworkAccess paraméterrel lettek létrehozva, csak attól a számítógéptől csatlakoztathatók újra, amelyen a munkamenet létrejött. A CredSSP-hitelesítést használó leválasztott munkamenetek újra csatlakoztathatók más számítógépekről. További információért lásd Disconnect-PSSession.
Ezt a paramétert a PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| 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 |
Session
| 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 |
-HostName
Egy SSH-alapú kapcsolat számítógépneveinek tömbjét adja meg. Ez hasonló a ComputerName paraméterhez, azzal a kivétellel, hogy a távoli számítógéphez való csatlakozás sSH-val történik a Windows WinRM helyett.
Ezt a paramétert a PowerShell 6.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
SSHHost
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-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.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | IdentityFilePath |
Paraméterkészletek
SSHHost
| 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 |
-Name
A PSSession
A névvel hivatkozhat a PSSession más parancsmagok, például Get-PSSession és Enter-PSSessionhasználatakor. A névnek nem kell egyedinek lennie a számítógépen vagy az aktuális munkamenetben.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-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éter használata például felülírja a Port kivonatolóban átadott kulcs-érték párokat.
Paramétertulajdonságok
| Típus: | Hashtable |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
SSHHost
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Port
A kapcsolathoz 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 a 5985, amely a HTTP WinRM-portja, és 5986, amely a HTTPS WinRM-portja.
Egy másik port használata előtt konfigurálnia kell a WinRM-figyelőt a távoli számítógépen az adott port figyelésére. A figyelő konfigurálásához használja az alábbi parancsokat:
winrm delete winrm/config/listener?Address=*+Transport=HTTPwinrm 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 |
SSHHost
| 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 |
-RunAsAdministrator
Azt jelzi, hogy a PSSession rendszergazdaként fut.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
ContainerId
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Session
A parancsmag által az új PSSessionmodellként használt PSSession objektumok tömbje. Ez a paraméter új PSSession objektumokat hoz létre, amelyek a megadott PSSession objektumokkal azonos tulajdonságokkal rendelkeznek.
Adjon meg egy változót, amely tartalmazza a PSSession objektumokat, vagy olyan parancsot, amely létrehozza vagy lekéri a PSSession objektumokat, például egy New-PSSession vagy Get-PSSession parancsot.
Az eredményül kapott PSSession objektumok számítógépnévvel, alkalmazásnévvel, kapcsolati URI-val, porttal, konfigurációnévvel, szabályozáskorláttal és SSL-értékkel rendelkeznek, de eltérő megjelenítendő névvel, azonosítóval és példányazonosítóval (GUID) rendelkeznek.
Paramétertulajdonságok
| Típus: | |
| 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
A munkamenet speciális beállításait adja meg. Adjon meg egy SessionOption objektumot, például a New-PSSessionOption parancsmaggal létrehozott objektumot, vagy egy kivonattáblát, amelyben a kulcsok munkamenet-beállításnevek, az értékek pedig munkamenet-beállításértékek.
A beállítások alapértelmezett értékeit a $PSSessionOption beállítási változó értéke határozza meg, ha be van állítva. Ellenkező esetben az alapértelmezett értékeket a munkamenet-konfigurációban megadott beállítások állítják be.
A munkamenet-beállításértékek elsőbbséget élveznek a $PSSessionOption beállítási változóban és a munkamenet-konfigurációban beállított munkamenetek alapértelmezett értékeivel szemben. Azonban nem elsőbbséget élveznek a munkamenet-konfigurációban beállított maximális értékekkel, kvótával vagy korlátokkal szemben.
Az alapértelmezett értékeket tartalmazó munkamenet-beállítások leírását lásd: New-PSSessionOption. A $PSSessionOption beállítási változóval kapcsolatos információkért lásd: about_Preference_Variables. További információ a munkamenet-konfigurációkról: about_Session_Configurations.
Paramétertulajdonságok
| Típus: | PSSessionOption |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
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 |
-SSHConnection
Ez a paraméter olyan kivonatolótömböt használ, amelyben minden kivonatoló egy vagy több kapcsolatparamétert tartalmaz a Secure Shell (SSH) kapcsolat létrehozásához (HostName, Port, UserName, KeyFilePath).
A kivonatoló kapcsolat paraméterei megegyeznek a SSHHost paraméterkészletének definiált paraméterével.
Az SSHConnection paraméter több munkamenet létrehozásához hasznos, ahol minden munkamenethez eltérő kapcsolati információ szükséges.
Ezt a paramétert a PowerShell 6.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
SSHHostHashParam
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-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.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Elfogadott értékek: | true |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
SSHHost
| 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 |
-Subsystem
Megadja az új PSSessionhasznált SSH-alrendszert.
Ez határozza meg a célon használni kívánt alrendszert a sshd_config. 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.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | powershell |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
SSHHost
| 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 |
-ThrottleLimit
Megadja a parancs futtatásához létrehozható egyidejű kapcsolatok maximális számát.
Ha kihagyja ezt a paramétert, vagy 0 (nulla) értéket ad meg, a rendszer az alapértelmezett 32értéket használja.
A szabályozás korlátja csak az aktuális parancsra vonatkozik, a munkamenetre és a számítógépre nem.
Paramétertulajdonságok
| Típus: | Int32 |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
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 |
VMId
| 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 |
VMName
| 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
| 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 |
ContainerId
| 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 |
-UserName
Megadja annak a fióknak a felhasználónevét, amellyel munkamenetet hoz létre a távoli számítógépen. 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, a kulcsfájl elérési útja a KeyFilePath paraméteren keresztül adható meg, és a rendszer nem kér jelszót. Vegye figyelembe, hogy ha az ügyfélfelhasználói kulcsfájl egy ismert SSH-helyen található, akkor a kulcsalapú hitelesítéshez nincs szükség a KeyFilePath paraméterre, és a felhasználói hitelesítés automatikusan megtörténik a felhasználónév alapján. További információkért tekintse meg a kulcsalapú felhasználói hitelesítés SSH-dokumentációját.
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.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
SSHHost
| 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 az 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 PowerShell-tartalmat. A UseSSL paraméter további védelmet nyújt, amely HTTP-kapcsolat helyett HTTPS-kapcsolaton keresztül küldi el 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: | False |
| 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 |
-UseWindowsPowerShell
Távoli kapcsolatot hoz létre egy új Windows PowerShell-futtatótérrel a helyi rendszeren.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
UseWindowsPowerShellParameterSet
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-VMId
Virtuálisgép-azonosítók tömbje. Ez a parancsmag elindít egy PowerShell Direct interaktív munkamenetet az egyes megadott virtuális gépeken. További információ: Virtuális gépek automatizálása és kezelése a PowerShell-használatával.
A Get-VM használatával megtekintheti a Hyper-V gazdagépen elérhető virtuális gépeket.
Paramétertulajdonságok
| Típus: | Guid[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | VMGuid |
Paraméterkészletek
VMId
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-VMName
A virtuális gépek nevének tömbje. Ez a parancsmag elindít egy PowerShell Direct interaktív munkamenetet az egyes megadott virtuális gépeken. További információ: Virtuális gépek automatizálása és kezelése a PowerShell-használatával.
A Get-VM használatával megtekintheti a Hyper-V gazdagépen elérhető virtuális gépeket.
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: | 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 |
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
String
Ehhez a parancsmaghoz karakterláncot irányíthat át.
System.URI
Ehhez a parancsmaghoz URI-t csövezhet.
PSSession
Erre a parancsmagra egy munkamenet-objektumot csövezhet.
Kimenetek
PSSession
Jegyzetek
A PowerShell a következő aliasokat tartalmazza New-PSSession:
Minden platform:
nsn
Ez a parancsmag a PowerShell-remoting infrastruktúrát használja. A parancsmag használatához konfigurálni kell a helyi számítógépet és a távoli számítógépeket a PowerShell-újraküldéshez. További információkért lásd: about_Remote_Requirements.
Ha PSSession szeretne létrehozni a helyi számítógépen, indítsa el a PowerShellt a Rendszergazdai beállítással.
Ha végzett a PSSession, a
Remove-PSSessionparancsmaggal törölje a PSSession, és engedje fel az erőforrásait.A HostName és SSHConnection paraméterkészletek a PowerShell 6.0-val kezdődően lettek befoglalva. A rendszer hozzáadta őket, 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-újraformálás ezeken a platformokon működik, ahol a PowerShell és az SSH telepítve és konfigurálva van. Ez nem azonos a WinRM-en alapuló korábbi Csak Windows rendszerű újraküldésekkel, és a WinRM-specifikus funkciók és korlátozások közül sok nem érvényes. Például 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 nem támogatottak. A PowerShell SSH-remoting beállításával kapcsolatos további információkért lásd PowerShell-remoting Over SSHcímű témakört.
A végrehajtható ssh a következő forrásokból szerzi be a konfigurációs adatokat az alábbi 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 ssh paraméterekre és beállításokra lesznek leképezve:
| 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. A ssh_config fájlokról további információt a ssh_config(5)című témakörben talál.