Vraćanje vrednosti iz powershell invoke-command agentu SQL-Server

Prilikom izrade vlastite metodologije upravljanja sigurnosnim kopijama na više MS-SQL servera, potrošio sam puno vremena proučavajući mehanizam prijenosa vrijednosti u PowerShell-u prilikom udaljenih poziva, stoga pišem ovom prilikom bilješku za sebe, možda će nekome drugome biti od koristi.

Dakle, za početak uzmimo najjednostavniji skript i pokrenimo ga lokalno:

$exitcode = $args[0]
Write-Host 'Izlaz na host.'
Write-Output 'Izlaz na izlaz.'
Write-Host ('ExitCode: ' + $exitcode)
Write-Output $exitcode
$host.SetShouldExit($exitcode)

Za pokretanje skripti koristit ću sljedeću CMD datoteku, neću je svaki put ponavljati:

@Echo OFF
PowerShell .TestOutput1.ps1 1
ECHO ERRORLEVEL=%ERRORLEVEL%

Na ekranu ćemo vidjeti sljedeće:

Izlaz na host.
Izlaz na izlaz.
ExitCode: 1
1
ERRORLEVEL=1


Sada pokrenimo ovu istu skriptu putem WSMAN-a (udaljeno):

Invoke-Command -ComputerName . -ScriptBlock { &'D:sqlagentTestOutput1.ps1' $args[0] } -ArgumentList $args[0]

I evo rezultata:

Izlaz na host.
Izlaz na izlaz.
ExitCode: 2
2
ERRORLEVEL=0

Divno, Errorlevel je negdje nestao, ali trebamo dobiti vrijednost iz skripte! Pokušavamo sljedeću konstrukciju:

$res=Invoke-Command -ComputerName . -ScriptBlock { &'D:sqlagentTestOutput1.ps1' $args[0] } -ArgumentList $args[0]

Ovdje je još zanimljivije. Cjeli izlaz u Output negdje je nestao:

Izlaz na host.
ExitCode: 2
ERRORLEVEL=0

Sada ću kao lirski odmak napomenuti da, ako unutar funkcije PowerShell napišete Write-Output ili jednostavno izraz bez dodjeljivanja nikakvoj varijabli (a to neizravno podrazumijeva izlaz u kanal Output), tada čak i pri lokalnom pokretanju na ekranu ništa neće biti ispisano! To je posljedica cijevne arhitekture PowerShell-a — svaka funkcija ima svoju cijev Output, za nju se stvara niz, i sve što u njega upadne smatra se rezultatom izvršenja funkcije, operator Return dodaje vraćenu vrijednost u ovu cijev kao posljednji element i prosljeđuje kontrolu nazad u pozivajuću funkciju. Za ilustraciju, lokalno ćemo izvršiti sljedeći skript:

Function Write-Log {
  Param( [Parameter(Mandatory=$false, ValueFromPipeline=$true)] [String[]] $OutString = "`r`n" )
  Write-Output ("Funkcija: "+$OutString)
  Return "ReturnValue"
}
Write-Output ("Glavno: "+"ParameterValue")
$res = Write-Log "ParameterValue"
$res.GetType()
$res.Length
$res | Foreach-Object { Write-Host ("Glavno: "+$_) }

I evo njegovog rezultata:

Glavno: ParameterValue

IsPublic IsSerial Name                                     BaseType
-------- -------- ----                                     --------
True     True     Object[]                                 System.Array
2
Glavno: Funkcija: ParameterValue
Glavno: ReturnValue

Glavna funkcija (tijelo skripte) također ima svoju cijev Output, a ako pokrenemo prvi skript iz CMD-a, preusmjeravajući izlaz u datoteku,

PowerShell .TestOutput1.ps1 1 > TestOutput1.txt

Na ekranu ćemo vidjeti

ERRORLEVEL=1

a u datoteci

Izlaz na host.
Izlaz na izlaz.
Izlazni kod: 1
1

ako učinimo sličan poziv iz powershell

PS D:sqlagent> .TestOutput1.ps1 1 > TestOutput1.txt

na ekranu će biti

Izlaz na host.
Izlazni kod: 1

a u datoteci

Izlaz na izlaz.
1

To se događa zato što CMD pokreće powershell, koji u odsustvu drugih uputstava miješa dva toka (Host i Izlaz) i predaje ih CMD-u, koji šalje u datoteku sve što je primio, a u slučaju pokretanja iz powershella ti se tokovi odvijaju odvojeno, a simbol preusmjeravanja utječe samo na Izlaz.

Vraćajući se na glavnu temu, prisjetimo se da objektni model .NET unutar powershella potpuno egzistira unutar jednog računala (jednog operativnog sustava); kod daljinskog pokretanja putem WSMAN-a, prijenos objekata odvija se kroz XML-serijalizaciju, što dodaje mnogo dodatnog interesa našim istraživanjima. Nastavimo eksperimentiranje pokretanjem sljedećeg koda:

$res=Invoke-Command -ComputerName . -ScriptBlock { &'D:sqlagentTestOutput1.ps1' $args[0] } -ArgumentList $args[0]
$res.GetType()
$host.SetShouldExit($res)

I evo što imamo na ekranu:

Izlaz na host.

Izlazni kod: 3

IsPublic IsSerial Name                                     BaseType
-------- -------- ----                                     --------
True     True     Object[]                                 System.Array
Nije moguće pretvoriti argument "exitCode", sa vrijednošću: "System.Object[]", za "SetShouldExit" u tip "System.Int32": "Nije moguće pretvoriti vrijednost "System.Object[]" tipa "System.Object[]" u tip "System.Int32"."
D:sqlagentTestOutput3.ps1:3 znak:1
+ $host.SetShouldExit($res)
+ ~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : NotSpecified: (:) [], MethodException
    + FullyQualifiedErrorId : MethodArgumentConversionInvalidCastArgument

ERRORLEVEL=0

Divan rezultat! To znači da prilikom poziva Invoke-Command zadržavamo podjelu cjevovoda na dva toka (Host i Izlaz), što nam pruža nadu za uspjeh. Pokušajmo ostaviti u toku Izlaz samo jednu vrijednost, zato ćemo promijeniti najprvi skript koji pokrećemo daljinski:

$exitcode = $args[0]
Write-Host 'Izlaz na host.'
#Write-Output 'Izlaz na izlaz.'
Write-Host ('Izlazni kod: ' + $exitcode)
Write-Output $exitcode
$host.SetShouldExit($exitcode)

Pokrenut ćemo ga ovako:

$res=Invoke-Command -ComputerName . -ScriptBlock { &'D:sqlagentTestOutput1.ps1' $args[0] } -ArgumentList $args[0]
$host.SetShouldExit($res)

i… DA, izgleda da je to pobjeda!

Izlaz na host.
Izlazni kod: 4

IsPublic IsSerial Name                                     BaseType
-------- -------- ----                                     --------
True     True     Int32                                    System.ValueType


ERRORLEVEL=4

Pokušajmo razumjeti što se dogodilo. Pokrenuli smo lokalno PowerShell, koji je, zauzvrat, pokrenuo PowerShell na udaljenom računaru i izvršio naš skript na njemu. Dva toka (Host i Output) sa udaljenog računara su serijalizovana i vraćena natrag, pri čemu je tok Output, ako je sadržavao jednu cijelu brojčanu vrijednost, bio pretvoren u tip Int32 i na taj način poslan primatelju, koji ga je koristio kao kod završetka pozivnog PowerShell-a.

I kao posljednje provjeravanje, stvorimo na serveru SQL zadatak od jednog koraka sa tipom „Operativni sistem (cmdexec)“ sa sljedećim tekstom:

PowerShell -NonInteractive -NoProfile "$res=Invoke-Command -ComputerName BACKUPSERVER -ConfigurationName SQLAgent -ScriptBlock {&'D:sqlagentTestOutput1.ps1' 6}; $host.SetShouldExit($res)"

URA! Zadatak je završio s greškom, tekst u dnevniku:

Izvršava se u ime korisnika: DOMAINagentuser. Izlaz u host. ExitCode: 6. Kod završetka procesa 6. Korak je završio s greškom.

Zaključci:

  • Izbjegavajte korištenje Write-Output i navođenje izraza bez dodjeljivanja. Zapamtite da premještanje ovog koda na drugo mjesto u skriptu može dovesti do neočekivanih rezultata.
  • U skriptama koje nisu namijenjene ručnom pokretanju, već za korištenje u vašim mehanizmima automatizacije, posebno za udaljene pozive putem WINRM, obavezno izvršite ručno rukovanje greškama putem Try/Catch i osigurajte da ovaj skript pošalje u Output tok upravo jednu vrijednost primitivnog tipa u svim okolnostima. Ako želite dobiti klasični Errorlevel — ova vrijednost mora biti numerička.

Izvor: habr.com

Kupite pouzdan hosting za sajtove uz zaštitu od DDoS, VPS VDS servere 🔥 Kupite pouzdan hosting za sajtove uz zaštitu od DDoS, VPS VDS servere | ProHoster