Categories: PowerShellWindows 10Windows Server 2019

Запуск простого HTTP веб-сервера средствами PowerShell

В целях тестирования или в качестве простой заглушки на этапе развертывания сервиса у меня периодически возникает необходимость в запуске простого веб сервера на Windows. Чтобы не устанавливать на хосте полноценный IIS, вполне можно запустить простейший HTTP веб сервер прямо из консоли PowerShell. Такой веб сервер можно запустить на любом TCP порту с помощью встроенного .NET класса System.Net.HttpListener .

Откройте консоль PowerShell и создайте прослушиватель Http:

$httpListener = New-Object System.Net.HttpListener

Затем нужно указать на каком порту должен слушать ваш листенер. В нашем примере я хочу запустить HTTP веб сервер на порту 9090:

$httpListener.Prefixes.Add("http://localhost:9090/")

Чтобы слушать на всех интерфейсах компьютера, используйте такой адрес: http://+:9090/

Для проверки доступности порта с удаленного компьютера используйте команду Test-NetConnection .

Запускаем прослушиватель:

$httpListener.Start()

Вы можете использовать в объекте HttpListener различные виды аутентификации (Basic, Digest, Windows, Negotiate, или NTLM) и также привязать SSL сертификат для доступа по HTTPS.

Если выполнить этот код, в Windows появится отдельный процесс, который ожидает подключения на порту 9090. Проверьте это с помощью команды:

nestat –na 9090

или выведите список открытых портов с помощью PowerShell :

Get-NetTCPConnection -State Listen | Select-Object -Property LocalAddress, LocalPort, State | Sort-Object LocalPort |ft

Не забудьте открыть данный порт в Windows Defender Firewall. Быстрее всего открыть порт фаейрвола с помощью команды PowerShell :

New-NetFirewallRule -DisplayName "AllowTestWebServer" -Direction Inbound -Protocol TCP –LocalPort 9090 -Action Allow

Теперь создайте на диске текстовый файл с HTML кодом, который должен отобразить ваш веб-сервер. Например:

<!DOCTYPE html>_x000D_<html>_x000D_<head>_x000D_<title>_x000D_Light PowerShell Web Server</title>_x000D_<meta name="viewport" content="width=device-width, initial-scale=1">_x000D_<style>_x000D_body {background-color:#ffffff;background-repeat:no-repeat;background-position:top left;background-attachment:fixed;}_x000D_h1{font-family:Arial, sans-serif;color:#000000;background-color:#ffffff;}_x000D_p {font-family:Georgia, serif;font-size:14px;font-style:normal;font-weight:normal;color:#000000;background-color:#ffffff;}_x000D_</style>_x000D_</head>_x000D_<body>_x000D_<h1>Test web page </h1>_x000D_<p>This web page was generated from PowerShell using the System.Net.HttpListener class</p>_x000D_ </body>_x000D_</html>_x000D_

Я сохранил этот HTML код в файл C:PStestwebpage.html в кодировке UTF8.

Теперь выполните следующие команды, чтобы прочитать ваш html файл и отправить ответ в браузер пользователя.

$context = $httpListener.GetContext() $context.Response.StatusCode = 200 $context.Response.ContentType = 'text/HTML' $WebContent = Get-Content -Path "C:PStestwebpage.html" -Encoding UTF8 $EncodingWebContent = [Text.Encoding]::UTF8.GetBytes($WebContent) $context.Response.OutputStream.Write($EncodingWebContent , 0, $EncodingWebContent.Length) $context.Response.Close()

Откройте URL адрес вашего HTTP сервера в браузере (http://localhost:9090) или получите содержимое веб страницы с помощью PowerShell . Данный скрипт вернет HTML код только один раз после чего ваш слушатель будет остановлен автоматически (обрабатывается только один запрос пользователя).

Освободите TCP порт:

$httpListener.Close()

Если нужно, чтобы HTTP сервер возвращал вашу страничку постоянно, нужно добавить PowerShell код в цикл. В следующем примере HTTP сервер будет запущен в цикле, который завершается при нажатии любой клавиши в консоль PowerShell.

write-host "Press any key to stop HTTP listener after next request" while (!([console]::KeyAvailable)) { $context = $httpListener.GetContext() $context.Response.StatusCode = 200 $context.Response.ContentType = 'text/HTML' $WebContent = Get-Content -Path "C:PStestwebpage.html" -Encoding UTF8 $EncodingWebContent = [Text.Encoding]::UTF8.GetBytes($WebContent) $context.Response.OutputStream.Write($EncodingWebContent , 0, $EncodingWebContent.Length) $context.Response.Close() Write-Output "" # Newline } $httpListener.Close()

Такой HTTP сервер на PowerShell будет жить пока вы не закроете консоль PowerShell или не закроете сеанс методом .Close .

Этот PowerShell скрипт можно запустить как службу Windows .

Такой легкий веб сервер можно запустить на любом хосте Windows без необходимости установки роли Internet Information Services или других сторонних программ. Права администратора также н не нужны. Можно использовать такой HTTPListener в качестве простейшего REST сервера или для получения информации с компьютера через HTTP.

admin