Megosztás a következőn keresztül:

Enable-PSRemoting

Modul:
Microsoft.PowerShell.Core Module

Úgy konfigurálja a számítógépet, hogy távoli parancsokat fogadjon.

Syntax

Default (Alapértelmezett) 

Enable-PSRemoting
    [-Force]
    [-SkipNetworkProfileCheck]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Ez a parancsmag csak a Windows platformon érhető el.

A Enable-PSRemoting parancsmag úgy konfigurálja a számítógépet, hogy a WS-Management technológiával küldött PowerShell távoli parancsokat fogadjon. WS-Management alapú PowerShell-újraformálás jelenleg csak Windows-platformon támogatott.

A PowerShell távelérés alapértelmezés szerint engedélyezve van a Windows Server platformokon. A Enable-PSRemoting használatával engedélyezheti a PowerShell-távoli elérést a támogatott Windows-verziókon, és ismét engedélyezheti a távoli elérést, ha az le van tiltva.

Ezt a parancsot csak egyszer kell futtatnia minden olyan számítógépen, amely parancsokat fog kapni. Nem kell futtatnia olyan számítógépeken, amelyek csak parancsokat küldenek. Mivel a konfiguráció elindítja a figyelőket a távoli kapcsolatok elfogadására, célszerű csak ott futtatni, ahol szükség van rá.

A PowerShell távoli elérésének engedélyezése a Windows ügyfélverzióin, amikor a számítógép nyilvános hálózathoz csatlakozik, általában tiltott, de ezt a korlátozást kihagyhatja a SkipNetworkProfileCheck paraméterrel. További információt a SkipNetworkProfileCheck paraméter leírásában talál.

Egyetlen számítógépen több PowerShell-telepítés is létezhet egymás mellett. A Enable-PSRemoting futtatása konfigurál egy távoli végpontot az adott telepítési verzióhoz, amelyben a parancsmagot futtatja. Ha tehát a Enable-PSRemoting parancsot futtatja, miközben a PowerShell 6.2-őt futtatja, a rendszer konfigurál egy távoli végpontot, amely a PowerShell 6.2-t futtatja. Ha a Enable-PSRemoting-t futtatja a PowerShell 7 előzetes verziójának futtatása közben, a rendszer egy távoli végpontot konfigurál, amely a PowerShell 7 előzetes verzióját futtatja.

Enable-PSRemoting szükség szerint két távoli végpont-konfigurációt hoz létre. Ha a végpontkonfigurációk már léteznek, akkor egyszerűen engedélyezve vannak. A létrehozott konfigurációk azonosak, de eltérő nevük van. Az egyiknek egy egyszerű neve lesz, amely a munkamenetet üzemeltető PowerShell-verziónak felel meg. A másik konfigurációnév részletesebb információkat tartalmaz a munkamenetet üzemeltető PowerShell-verzióról. Ha például Enable-PSRemoting a PowerShell 6.2-ben fut, két konfigurált végpontot fog kapni, PowerShell.6, PowerShell.6.2.2. Ez lehetővé teszi, hogy kapcsolatot hozzon létre a legújabb PowerShell 6 gazdagépverzióhoz a PowerShell.6 egyszerű nevénekhasználatával. Vagy csatlakozhat egy adott PowerShell-gazdagépverzióhoz a PowerShell.6.2.2hosszabb név használatával.

Az újonnan engedélyezett távoli elérési végpontok használatához név szerint kell megadnia őket a ConfigurationName paraméterrel, amikor távoli kapcsolatot hoz létre a Invoke-Command,New-PSSession,Enter-PSSession parancsmagokkal. További információ: 4. példa.

A Enable-PSRemoting parancsmag a következő műveleteket hajtja végre:

  • Futtatja a Set-WSManQuickConfig parancsmagot, amely a következő feladatokat hajtja végre:
    • Elindítja a WinRM szolgáltatást.
    • A WinRM szolgáltatás indítási típusát automatikusra állítja.
    • Létrehoz egy figyelőt, amely bármilyen IP-címen fogadja a kéréseket.
    • Engedélyezi a tűzfalkivételt a WS-Management kommunikációhoz.
    • Szükség esetén létrehozza az egyszerű és hosszú nevű munkamenetvégpont-konfigurációkat.
    • Engedélyezi az összes munkamenet-konfigurációt.
    • Módosítja az összes munkamenet-konfiguráció biztonsági leíróját a távelérés engedélyezéséhez.
  • Újraindítja a WinRM szolgáltatást, hogy az előző módosításokat érvényessé tegye.

A parancsmag Windows-platformon való futtatásához indítsa el a PowerShellt a Futtatás rendszergazdaként lehetőséggel. Ez a parancsmag nem érhető el a PowerShell Linux vagy MacOS verziójában.

Figyelmeztetés

Ez a parancsmag nem befolyásolja a Windows PowerShell által létrehozott távoli végpontkonfigurációkat. Ez csak a PowerShell 6-os és újabb verziójával létrehozott végpontokat érinti. A Windows PowerShell által üzemeltetett PowerShell-újrakapcsolódási végpontok engedélyezéséhez és letiltásához futtassa a Enable-PSRemoting parancsmagot egy Windows PowerShell-munkameneten belül.

Példák

1. példa: Számítógép konfigurálása távoli parancsok fogadásához

Ez a parancs úgy konfigurálja a számítógépet, hogy távoli parancsokat fogadjon.

Enable-PSRemoting

WARNING: PowerShell remoting has been enabled only for PowerShell Core configurations and
does not affect Windows PowerShell remoting configurations. Run this cmdlet in Windows
PowerShell to affect all PowerShell remoting configurations.

2. példa: Számítógép konfigurálása távoli parancsok fogadásához megerősítési kérés nélkül

Ez a parancs úgy konfigurálja a számítógépet, hogy távoli parancsokat fogadjon. A Force paraméter letiltja a felhasználói kéréseket.

Enable-PSRemoting -Force

WARNING: PowerShell remoting has been enabled only for PowerShell Core configurations and
does not affect Windows PowerShell remoting configurations. Run this cmdlet in Windows
PowerShell to affect all PowerShell remoting configurations.

3. példa: Távelérés engedélyezése ügyfeleken

Ez a példa bemutatja, hogyan engedélyezheti a távoli hozzáférést a nyilvános hálózatokról a Windows operációs rendszer ügyfélverzióiban. A tűzfalszabály neve eltérő lehet a Windows különböző verzióiban. A szabályok listájának megtekintéséhez használja a Get-NetFirewallRule. A tűzfalszabály engedélyezése előtt tekintse meg a szabály biztonsági beállításait annak ellenőrzéséhez, hogy a konfiguráció megfelel-e a környezetnek.

Get-NetFirewallRule -Name 'WINRM*' | Select-Object -Property Name

Name
----
WINRM-HTTP-In-TCP-NoScope
WINRM-HTTP-In-TCP
WINRM-HTTP-Compat-In-TCP-NoScope
WINRM-HTTP-Compat-In-TCP

Enable-PSRemoting -SkipNetworkProfileCheck -Force
Set-NetFirewallRule -Name 'WINRM-HTTP-In-TCP' -RemoteAddress Any

Alapértelmezés szerint Enable-PSRemoting olyan hálózati szabályokat hoz létre, amelyek engedélyezik a magán- és tartományi hálózatokról való távelérést. A parancs a SkipNetworkProfileCheck paramétert használja a helyi alhálózaton lévő nyilvános hálózatokról való távelérés engedélyezéséhez. A parancs megadja a Force paramétert a megerősítést kérő üzenetek letiltásához.

A SkipNetworkProfileCheck paraméter nincs hatással a Windows operációs rendszer kiszolgálói verzióira, amelyek alapértelmezés szerint engedélyezik az ugyanazon helyi alhálózaton lévő nyilvános hálózatokról való távelérést.

A Set-NetFirewallRule modul parancsmagja hozzáad egy tűzfalszabályt, amely lehetővé teszi a nyilvános hálózatokról való távoli hozzáférést bármely távoli helyről. Ide tartoznak a különböző alhálózatok helyei.

4. példa: Távoli munkamenet létrehozása az újonnan engedélyezett végpontkonfigurációhoz

Ez a példa bemutatja, hogyan engedélyezheti a PowerShell-újramotálást a számítógépen, hogyan keresheti meg a konfigurált végpontneveket, és hogyan hozhat létre távoli munkamenetet az egyik végponton.

Az első parancs lehetővé teszi a PowerShell távoli elérés engedélyezését a számítógépen.

A második parancs felsorolja a végpontkonfigurációkat.

A harmadik parancs létrehoz egy távoli PowerShell-munkamenetet ugyanarra a gépre, és név alapján adja meg a PowerShell.7 végpontot. A távoli munkamenet a PowerShell 7 legújabb verziójával (7.3.0) lesz üzemeltetve.

Az utolsó parancs hozzáfér a távoli munkamenet $PSVersionTable változóhoz a munkamenetet üzemeltető PowerShell-verzió megjelenítéséhez.

Enable-PSRemoting -Force

Get-PSSessionConfiguration

$session = New-PSSession -ComputerName localhost -ConfigurationName PowerShell.7

Invoke-Command -Session $session -ScriptBlock { $PSVersionTable }

WARNING: PowerShell remoting has been enabled only for PowerShell Core configurations and
does not affect Windows PowerShell remoting configurations. Run this cmdlet in Windows
PowerShell to affect all PowerShell remoting configurations.

Name          : PowerShell.7
PSVersion     : 7.3
StartupScript :
RunAsUser     :
Permission    : NT AUTHORITY\INTERACTIVE AccessAllowed,
                BUILTIN\Administrators AccessAllowed,
                BUILTIN\Remote Management Users AccessAllowed

Name          : PowerShell.7.3.0
PSVersion     : 7.3
StartupScript :
RunAsUser     :
Permission    : NT AUTHORITY\INTERACTIVE AccessAllowed,
                BUILTIN\Administrators AccessAllowed,
                BUILTIN\Remote Management Users AccessAllowed

Name                           Value
----                           -----
PSCompatibleVersions           {1.0, 2.0, 3.0, 4.0…}
PSEdition                      Core
PSRemotingProtocolVersion      2.3
Platform                       Win32NT
SerializationVersion           1.1.0.1
GitCommitId                    6.2.2
WSManStackVersion              3.0
PSVersion                      6.2.2
OS                             Microsoft Windows 10.0.18363

Megjegyzés:

A tűzfalszabály neve a Windows verziójától függően eltérő lehet. A Get-NetFirewallRule parancsmaggal listázhatja a rendszer szabályainak nevét.

Paraméterek

-Confirm

Megerősítést kér a parancsmag futtatása előtt.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:False
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:Cf

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

-Force

Kényszeríti a parancs futtatását anélkül, hogy felhasználói megerősítést kérne.

Paramétertulajdonságok

Típus:SwitchParameter
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

-SkipNetworkProfileCheck

Azt jelzi, hogy ez a parancsmag lehetővé teszi a távoli kapcsolódást a Windows operációs rendszer ügyfélverzióin, ha a számítógép nyilvános hálózaton van. Ez a paraméter engedélyezi a nyilvános hálózatok tűzfalszabályát, amely csak az azonos helyi alhálózatban lévő számítógépekről engedélyezi a távelérést.

Ez a paraméter nem érinti a Windows operációs rendszer kiszolgálói verzióit, amelyek alapértelmezés szerint helyi alhálózati tűzfalszabállyal rendelkeznek a nyilvános hálózatokhoz. Ha a helyi alhálózati tűzfalszabály le van tiltva egy kiszolgálóverzióban, Enable-PSRemoting újra engedélyezi azt, függetlenül a paraméter értékétől.

A helyi alhálózati korlátozás eltávolításához és a nyilvános hálózatokon lévő összes helyről való távelérés engedélyezéséhez használja a Set-NetFirewallRule modulban található parancsmagot.

Ezt a paramétert a 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

(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

-WhatIf

Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:False
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:Wi

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

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

None

Ehhez a parancsmaghoz nem lehet objektumokat csövezni.

Kimenetek

String

Ez a parancsmag az eredményeket leíró sztringeket adja vissza.

Jegyzetek

Ez a parancsmag csak Windows-platformokon érhető el.

A Windows operációs rendszer kiszolgálói verzióiban Enable-PSRemoting olyan tűzfalszabályokat hoz létre a magán- és tartományi hálózatokhoz, amelyek engedélyezik a távelérést, és létrehoz egy tűzfalszabályt a nyilvános hálózatokhoz, amelyek csak az azonos helyi alhálózatban lévő számítógépekről engedélyezik a távelérést.

A Windows operációs rendszer ügyfélverzióiban Enable-PSRemoting olyan tűzfalszabályokat hoz létre a magán- és tartományi hálózatokhoz, amelyek korlátlan távelérést biztosítanak. Ha olyan tűzfalszabályt szeretne létrehozni a nyilvános hálózatokhoz, amely lehetővé teszi a távoli hozzáférést ugyanabból a helyi alhálózatból, használja a SkipNetworkProfileCheck paramétert.

A Windows operációs rendszer ügyfél- vagy kiszolgálóverzióiban hozzon létre egy tűzfalszabályt a nyilvános hálózatokhoz, amelyek eltávolítják a helyi alhálózati korlátozást és engedélyezik a távelérést, a NetSecurity modulban található Set-NetFirewallRule parancsmaggal futtassa a következő parancsot: Set-NetFirewallRule -Name "WINRM-HTTP-In-TCP-PUBLIC" -RemoteAddress Any

Enable-PSRemoting az összes munkamenet-konfiguráció engedélyezését az összes munkamenet-konfiguráció Engedélyezett tulajdonságának értékének $True-ra állításával teszi lehetővé.

Enable-PSRemoting eltávolítja a Deny_All és Network_Deny_All beállításait. Ez távoli hozzáférést biztosít a helyi használatra fenntartott munkamenet-konfigurációkhoz.