Microsoft Powershell-anslutning

Microsoft Powershell Connector-funktioner är byggda ovanpå Generic Python Script anslutningen . Funktionaliteten implementeras av ett powershell-event.py python-skript, som tillhandahålls av Matrix42 från och med version 2026.1. Det skriptet ansvarar för att anropa kunders Powershell-skript från fjärr-Windows-server via SSH-anslutning.

När Microsoft Powershell Connector tas i bruk krävs det att

• Kunden har en egen Windows-server som har dessa Powershell-skript att anropa
• Samma Windows-server måste ha en SSH-server påslagen och konfigurerad för att stödja autentisering med privat/publik nyckel (andra autentiseringsmetoder stöds inte)
• Kunden har skapat en Windows-användare med nödvändiga behörigheter för att köra MS Powershell-skript och logga in på servern via SSH.
• Anslutningsuppgifterna är uppfyllda och en händelsebaserad uppgift är konfigurerad för att utlösa Powershell.
• Arbetsflödet måste innehålla en Orchestration-nod för att anropa den händelsebaserade uppgiften för att utlösa den.
• Matrix42 skapar ett privat/publikt nyckelpar och skickar en publik nyckel till kunden. Den publika nyckeln måste konfigureras till SSH-servern. Och Matrix42 konfigurerar den privata nyckeln till Connector-konfigurationen.

Funktioner som inte stöds

• Powershell kan inte utlösas från schemalagda uppgifter med hjälp av detta powershell-event.py python-skript

Konfigurera anslutning

För att få åtkomst till kopplingshantering måste användaren ha behörighet till plattformskonfiguration.

1. Öppna administrationsområdet (en kugghjulssymbol).
2. Öppna kopplingsvyn.
3. Välj + ny kontakt

4. Välj datakälltypen som Generic Python Script

5. Uppfylla information

• Fyll i ett unikt kopplingsnamn för kopplingen
• Välj powershell-event.py skript från provisioneringsskriptfältet.
• Lösenord för parameterkryptering behövs för att dölja/visa parametrar efter att anslutningen har sparats (kom ihåg att lagra lösenordet på en säker plats).
  
  Exempel på Linux-kommando för att generera ett privat/publikt nyckelpar:
  ssh-keygen -t ed25519 -f ~/.ssh/id_ed25519_windows_automation
  Lämna lösenordet tomt.
  
  Parametrarna måste vara i exakt detta format:
  { "ssh": {"private_key": "-----BEGIN OPENSSH PRIVATE KEY-----\nb4ClbnNzaC1rZXktdjEAbbAABG5vbmUAAAAxxxxxxQAAAAAAAAABAAAAMwAAAAtzc2gtZW\nQyNTUxOQAAACB2zQv/80M8ICgv95iT7jCIxnn/YL1tzLvm6S+QaC3bDAAAALBayLNTWsiz\nUwAAAAtzc2gtZWQyNTUxOQAAACB2zQv/80M8ICgv95iT7jCIxnn/YL1tzLvm6S+QaC3bDA\nAAAEAeY5TsWlBuSeX+3Sz/tJTqJU+XgpHHr7QjfRlbr/f7RHbNC//zRXsgKC/3mJPuMIjG\nef9gvW3Mu+bpL5BoLdsMAAABKXJpa3BuaWVtaW5lbkBSaWt1cy1NYWNCb29rLVByby0yMD\nI0LmxvY2FsAQIDAB==\n-----END OPENSSH PRIVATE KEY-----", "user": "MATRIX42\\sshrunneruser", "host": "1.2.3.4", "timeout": 30,    "remote_command": { "executable": "powershell.exe", "arguments": ["-No Pro file" ]  } }, "redirect_stderr_to_stdout": true}
  
  Radbrytningar för private_key värdet måste ersättas med \n som i exemplet ovan. Denna privata nyckel är till för user till Windows-servern via ssh.
  user är den användare som används för att logga in på Windows-servern och utlösa Powershell-skript
  host är IP-adressen eller värdnamnet för den Windows-server som innehåller dessa Powershell-skript
  timeout kan lämnas till standardvärdet 30 som i exemplet ovan
  remote_command ska vara exakt som i exemplet ovan

• WebAPI användare behövs när kopplingen skriver data till kundens lösning
• WebAPI lösenord behövs när anslutningen skriver data till kundens lösning

6. Spara kopplingen med hjälp av knappen Spara. Nu är kopplingen konfigurerad och du kan gå vidare till uppgiften Konfigurera händelsebaserad.

Konfigurera händelsebaserad uppgift

Skapa ny händelsebaserad uppgift

1. Ange ett beskrivande uppgiftsnamn
2. Välj aktivitetsanvändning: Händelse
3. Ange mappningstyp: Generisk mall
4. Ange målmall: från vilken data skickas till denna händelseuppgift
5. Ange målmapp: från vilken data skickas till denna händelseuppgift

6. Skapa mappningar

Du måste alltid ha minst en mappning: ps_script_path_and_name som ska mappas till ett attribut som innehåller den informationen, annars vet inte händelseuppgiften vilken Powershell som ska utlösas.

Dessutom kan du ha en eller flera parametrar. Du måste ställa in dessa i mappningstabellen med exakt samma namn som i exemplet; parameter1, parameter2, parameter3 etc. beroende på hur många parametrar ditt Powershell-skript förväntar sig att få.

7. Spara händelseuppgift.
8. Nästa steg är att skapa ett arbetsflöde med en orkestreringsnod som anropar denna händelseuppgift.

Anropshändelseuppgift från WorkFlow

Lägg till orkestreringsnoden i ditt arbetsflöde

1. Namn - ange beskrivande namn
2. Beskrivning
3. Orkestrera - Inbyggda kontakter
4. Datakälla - Generiskt Python Script
5. Aktivitet - Kör händelseuppgift
6. Mål - Välj händelseuppgift som du tidigare skapade för detta ändamål
7. Respose - välj attribut som används för att lagra lyckat körd Powershell-utdata
8. Pro : välj attribut som används för att lagra felmeddelanden om misslyckade Powershell-anrop

Powershell-skriptformat som stöds av vår Microsoft Powershell-anslutning

• Läser skriptparametrar som strängparametrar (som i exemplet).
• Kan innehålla 0 till n parametrar.
• Avsluta med avslutningskoden 0 när skriptet har körts. Du kan också returnera ok-meddelandet som json, som ska lagras i nodsvarsfältet på datakortet.
• Avsluta med avslutningskod större än 0 när det uppstod ett fel. Du kan också returnera felmeddelandet som json, som ska lagras i provisioneringsundantagsfältet för datakortet.

Exemplet lagrar kontroller som visar att två parametrar har angetts och skriver sedan dessa till en fil på en Windows-dator. Om den första parametern var lika med "failuretest" returnerar den felkod och meddelande till arbetsflödet.

param (
    [string]$Param1,
    [string]$Param2
)

# Validate required parameters
if ([string]::IsNullOrEmpty($Param1) -or [string]::IsNullOrEmpty($Param2)) {
    $errorJson = @{ error = "Wrong number of attributes for Powershell script" } | ConvertTo-Json -Compress
    Write-Output $errorJson
    exit 1
}

# Folder where this script is located
$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Definition
$file = Join-Path $scriptDir "pstest.txt"

# Failure case
if ($Param1 -eq "failuretest") {
    $errorJson = @{ error = "Calling powershell FAILED" } | ConvertTo-Json -Compress
    Write-Output $errorJson
    exit 1
}

# Success case: write file
"$Param1`n$Param2" | Out-File -FilePath $file -Encoding UTF8 -Force

$successJson = @{ response = "Calling powershell successfull" } | ConvertTo-Json -Compress
Write-Output $successJson
exit 0