Philip Wiki - docs:powershell:modules

Polaris

anonymous@undisclosed.example.com (Anonymous) — Sat, 04 Jun 2022 08:22:44 +0000

Polaris

Обзор

Кросс-платформенный, минималистичный веб-фреймворк для PowerShell

Ссылки

Установка

PS > Install-Module Polaris

Пример работы

New-PolarisGetRoute -Path "/helloworld" -Scriptblock {
    $Response.Send('Hello World!');
}
 
Start-Polaris

Советы

HTTPS (SSL)

Работа по HTTPS¹⁾

Генерируем сертификат

$GUID = New-GUID | Select-Object -ExpandProperty GUID
$HostName = 'localhost'
$Port = '443'
 
#Create Cert
$Cert = New-SelfSignedCertificate -DnsName $HostName -CertStoreLocation cert:\LocalMachine\MY
#Bind cert to port
#Invoke-Expression -Command "netsh http add sslcert ipport=0.0.0.0:$($Port) certhash=$($Cert.Thumbprint) appid='$($AppID)' certstorename=MY"
Add-NetIPHttpsCertBinding -CertificateHash $Cert.Thumbprint -ApplicationId "{$GUID}" -IpPort "0.0.0.0:$Port" -CertificateStoreName My -NullEncryption:$false

# просмотр существующих http-сертификатов
netsh http show sslcert
# удаление
netsh http delete sslcert ipport=0.0.0.0:$Port

Запускаем Polaris

New-PolarisGetRoute -Path "/HelloWorld" -Scriptblock {
 
    $Respone = "Hello World"
 
    $Response.Send($Respone);
}
 
Start-Polaris -Port $Port -Https

ещё один вариант работы (импорта) с сертификатом

$CertificatePassword = "PasswordToDecryptCertificate" |
ConvertTo-SecureString -AsPlainText -Force
 
$CertificateImport = Import-PfxCertificate -FilePath "$Local\Certificate.pfx" -CertStoreLocation Cert:\LocalMachine\My -Password $CertificatePassword
 
$GUID = New-GUID | Select-Object -ExpandProperty GUID
Add-NetIPHttpsCertBinding -CertificateHash $CertificateImport.Thumbprint -ApplicationId "{$GUID}" -IpPort "0.0.0.0:$Port" -CertificateStoreName My -NullEncryption:$false

Запуск как службы

Polaris Script

Path: C:\Scripts\Polaris.ps1

Import-Module C:\Polaris\Polaris.psm1
New-WebRoute -Path "/helloworld" -Method "GET" -ScriptBlock {
    $response.Send('Hello World');
}
Start-Polaris
 
while ($Polaris.Listener.IsListening) {
   Wait-Event callbackeventbridge.callbackcomplete
}

NSSM Script

function Install-Service {
    Param(
        [string]$nssmPath = '.',
        [string]$Name,
        [string]$Description,
        [string]$Executable,
        [string]$Arguments
    )
 
    $nssm = Join-Path -Path $nssmPath -ChildPath 'nssm.exe'
    & $nssm install $name $executable $arguments
    $null = & $nssm set $name Description $description
    Start-Service $name
}
 
Install-Service -Name Polaris -Description 'PowerShell HTTP API Service' -Executable pwsh.exe -Arguments '-ExecutionPolicy Bypass -Command C:\Scripts\Polaris.ps1'

Test

Invoke-RestMethod -Uri http://localhost:8080/helloworld -Method GET

Чуть подробнее про тоже самое тут: https://4sysops.com/archives/how-to-run-a-powershell-script-as-a-windows-service

Можно ещё попробовать вот так, без внешних утилит:

New-Service -Name "Polaris" -Description 'PowerShell HTTP API Service' -BinaryPathName "powershell.exe -ExecutionPolicy Bypass -Command C:\Scripts\Polaris.ps1"

Разное

Вроде как с модулем PSHTML можно подружиться и будет круто… Много примеров здесь.

powershell, polaris, web, module, framework, ssl, https, http

¹⁾

https://jeremymcgee.com/powershell/polaris/https/2018/10/29/Polaris-HTTPS.html

PSSQLite

anonymous@undisclosed.example.com (Anonymous) — Sat, 04 Jun 2022 08:22:47 +0000

PSSQLite

Обзор

Модуль для работы с SQLite

Ссылки

GitHub

Установка

PS > Install-Module PSSQLite

Пример работы

# One time setup
    # Download the repository
    # Unblock the zip
    # Extract the PSSQLite folder to a module path (e.g. $env:USERPROFILE\Documents\WindowsPowerShell\Modules\)
 
    #Simple alternative, if you have PowerShell 5, or the PowerShellGet module:
        Install-Module PSSQLite
 
# Import the module.
    Import-Module PSSQLite    #Alternatively, Import-Module \\Path\To\PSSQLite
 
# Get commands in the module
    Get-Command -Module PSSQLite
 
# Get help for a command
    Get-Help Invoke-SQLiteQuery -Full
 
# Create a database and a table
    $Query = "CREATE TABLE NAMES (fullname VARCHAR(20) PRIMARY KEY, surname TEXT, givenname TEXT, BirthDate DATETIME)"
    $DataSource = "C:\Names.SQLite"
 
    Invoke-SqliteQuery -Query $Query -DataSource $DataSource
 
# View table info
    Invoke-SqliteQuery -DataSource $DataSource -Query "PRAGMA table_info(NAMES)"
 
# Insert some data, use parameters for the fullname and birthdate
    $query = "INSERT INTO NAMES (fullname, surname, givenname, birthdate) VALUES (@full, 'Cookie', 'Monster', @BD)"
 
    Invoke-SqliteQuery -DataSource $DataSource -Query $query -SqlParameters @{
        full = "Cookie Monster"
        BD   = (get-date).addyears(-3)
    }
 
# View the data
    Invoke-SqliteQuery -DataSource $DataSource -Query "SELECT * FROM NAMES"
 
#Build up some fake data to bulk insert, convert it to a datatable
    $DataTable = 1..10000 | %{
        [pscustomobject]@{
            fullname = "Name $_"
            surname = "Name"
            givenname = "$_"
            BirthDate = (Get-Date).Adddays(-$_)
        }
    } | Out-DataTable
 
#Insert the data within a single transaction (SQLite is faster this way)
    Invoke-SQLiteBulkCopy -DataTable $DataTable -DataSource $DataSource -Table Names -NotifyAfter 1000 -verbose
 
#View all the data!
    Invoke-SqliteQuery -DataSource $DataSource -Query "SELECT * FROM NAMES"

powershell, sql, sqlite, module

Модули

anonymous@undisclosed.example.com (Anonymous) — Sat, 04 Jun 2022 08:22:49 +0000

Модули

Обзор

Список модулей для Powershell

Содержание

Название	Описание	Документация
File System Security PowerShell Module	модуль для работы с правами NTFS	Часть 1, Часть 2
PS2EXE-GUI	модуль для конвертации ps1-скриптов в exe	-
ImportExcel	экспорт и импорт Excel-документов (активен)	-
PSWriteColor	Простое использование цветов в консоли и скриптах	-
oh-my-posh	Прокачка консоли	-

Устанавливать модули лучше всего из и с PowerShell Gallery

# обновить все установленные модули
Get-InstalledModule | Update-Module

Искать в Галереи можно командлетами Find-Module и Find-Script
Сохранять в вашу систему из Галереи командлетами Save-Module и Save-Script
Устанавливать из Галереи командлетами Install-Module и Install-Script
Загрухать в галерею командлетами Publish-Module и Publish-Script
Добавить собственный репозиторий командлетом Register-PSRepository

Функции

Полезные функции от автора LazyAdmin

powershell, module, list