vzdálené komunikace WS-Management (WSMan) v PowerShellu

Pokyny k vytvoření koncového bodu vzdálené komunikace

Balíček PowerShellu pro Windows zahrnuje modul plug-in WinRM (pwrshplugin.dll) a instalační skript (Install-PowerShellRemoting.ps1) v $PSHome. Tyto soubory umožňují PowerShellu přijímat příchozí vzdálená připojení PowerShellu při zadání jeho koncového bodu.

Motivace

Instalace PowerShellu může navázat relace PowerShellu pro vzdálené počítače používající a New-PSSessionEnter-PSSession. Aby mohl uživatel přijímat příchozí vzdálená připojení PowerShellu, musí vytvořit koncový bod vzdálené komunikace WinRM. Jedná se o explicitní scénář výslovného souhlasu, kdy uživatel spustí Install-PowerShellRemoting.ps1 k vytvoření koncového bodu WinRM. Instalační skript je krátkodobé řešení, dokud nepřidáme další funkce pro Enable-PSRemoting provedení stejné akce. Další podrobnosti najdete v tématu problém č. 1193.

Akce skriptu

Skript

  1. Vytvoří adresář pro modul plug-in v rámci $env:windir\System32\PowerShell
  2. Zkopíruje pwrshplugin.dll do daného umístění.
  3. Vygeneruje konfigurační soubor.
  4. Zaregistruje modul plug-in pomocí WinRM.

Registrace

Skript se musí spouštět v relaci PowerShellu na úrovni správce a běžet ve dvou režimech.

Spustí se instancí PowerShellu, kterou zaregistruje.

Install-PowerShellRemoting.ps1

Spustí se jinou instancí PowerShellu jménem instance, kterou zaregistruje.

<path to powershell>\Install-PowerShellRemoting.ps1 -PowerShellHome "<absolute path to the instance's $PSHOME>"

Příklad:

Set-Location -Path 'C:\Program Files\PowerShell\6.0.0\'
.\Install-PowerShellRemoting.ps1 -PowerShellHome "C:\Program Files\PowerShell\6.0.0\"

Poznámka

Skript pro registraci vzdálené komunikace restartuje WinRM. Všechny existující relace PSRP se ukončí hned po spuštění skriptu. Pokud se spustí během vzdálené relace, skript připojení ukončí.

Připojení k novému koncovému bodu

Vytvořte relaci PowerShellu s novým koncovým bodem PowerShellu zadáním -ConfigurationName "some endpoint name". Pokud se chcete připojit k instanci PowerShellu z výše uvedeného příkladu, použijte některou z těchto akcí:

New-PSSession ... -ConfigurationName "powershell.6.0.0"
Enter-PSSession ... -ConfigurationName "powershell.6.0.0"

Všimněte si, že New-PSSession a Enter-PSSession vyvolání, která nezadávají-ConfigurationName, bude cílit na výchozí koncový bod PowerShellu. microsoft.powershell