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=0Divno, 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=0Sada ć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: ReturnValueGlavna 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=1a 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.txtna ekranu će biti
Izlaz na host.
Izlazni kod: 1a u datoteci
Izlaz na izlaz.
1To 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=0Divan 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=4Pokuš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
