მნიშვნელობის დაბრუნება powershell invoke-command-დან SQL Server აგენტზე

მრავალი MS-SQL სერვერზე სარეზერვო ასლების მართვის საკუთარი მეთოდოლოგიის შექმნისას, მე დიდი დრო გავატარე Powershell-ში მნიშვნელობების გადაცემის მექანიზმის შესწავლაზე დისტანციური ზარების დროს, ამიტომ ჩემს თავს ვწერ შეხსენებას, თუ ეს სასარგებლო იქნება. სხვას.

ასე რომ, დავიწყოთ მარტივი სკრიპტით და გავუშვათ იგი ადგილობრივად:

$exitcode = $args[0]
Write-Host 'Out to host.'
Write-Output 'Out to output.'
Write-Host ('ExitCode: ' + $exitcode)
Write-Output $exitcode
$host.SetShouldExit($exitcode)

სკრიპტების გასაშვებად, მე გამოვიყენებ შემდეგ CMD ფაილს, ყოველ ჯერზე არ ჩავრთავ მას:

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

ეკრანზე ვნახავთ შემდეგს:

Out to host.
Out to output.
ExitCode: 1
1
ERRORLEVEL=1

ახლა მოდით გავუშვათ იგივე სკრიპტი WSMAN-ის საშუალებით (დისტანციურად):

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

და აი შედეგი:

Out to host.
Out to output.
ExitCode: 2
2
ERRORLEVEL=0

შესანიშნავია, Errorlevel სადღაც გაქრა, მაგრამ ჩვენ უნდა მივიღოთ მნიშვნელობა სკრიპტიდან! მოდით ვცადოთ შემდეგი დიზაინი:

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

ეს კიდევ უფრო საინტერესოა. გაგზავნა Output-ში სადღაც გაქრა:

Out to host.
ExitCode: 2
ERRORLEVEL=0

ახლა, როგორც ლირიკული დიგრესიის სახით, მე აღვნიშნავ, რომ თუ Powershell ფუნქციის შიგნით ჩაწერთ Write-Output ან უბრალოდ გამონათქვამს რაიმე ცვლადისთვის მინიჭების გარეშე (და ეს იგულისხმება გამომავალი გამომავალი არხზე), მაშინაც კი, როცა ადგილობრივად მუშაობს, არაფერი არ გამოჩნდება ეკრანზე! ეს არის powershell მილსადენის არქიტექტურის შედეგი - თითოეულ ფუნქციას აქვს თავისი გამომავალი მილსადენი, მისთვის იქმნება მასივი და ყველაფერი, რაც მასში შედის, ითვლება ფუნქციის შესრულების შედეგად, Return ოპერატორი დაამატებს დაბრუნების მნიშვნელობას იმავეს. მილსადენი, როგორც ბოლო ელემენტი და გადასცემს კონტროლს გამოძახების ფუნქციას. საილუსტრაციოდ, მოდით გავუშვათ შემდეგი სკრიპტი ადგილობრივად:

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

და აი შედეგი:

Main: ParameterValue

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

მთავარ ფუნქციას (სკრიპტის სხეულს) ასევე აქვს საკუთარი გამომავალი მილსადენი, და თუ პირველ სკრიპტს CMD-დან გავუშვით, გამომავალი ფაილზე გადამისამართება,

PowerShell .TestOutput1.ps1 1 > TestOutput1.txt

შემდეგ ჩვენ ვნახავთ ეკრანზე

ERRORLEVEL=1

და ფაილში

Out to host.
Out to output.
ExitCode: 1
1

თუ ჩვენ გავაკეთებთ მსგავს ზარს powershell-იდან

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

შემდეგ ის ეკრანზე იქნება

Out to host.
ExitCode: 1

და ფაილში

Out to output.
1

ეს ხდება იმის გამო, რომ CMD გამოუშვებს powershell-ს, რომელიც სხვა ინსტრუქციების არარსებობის შემთხვევაში აერთიანებს ორ ძაფს (ჰოსტს და გამომავალს) და აძლევს მათ CMD-ს, რომელიც აგზავნის ყველაფერს, რაც მიიღო ფაილში, და Powershell-იდან გაშვების შემთხვევაში, ეს ორი ძაფი ცალ-ცალკე არსებობს და სიმბოლოების გადამისამართებები გავლენას ახდენს მხოლოდ გამომავალზე.

მთავარ თემას რომ დავუბრუნდეთ, გავიხსენოთ, რომ Powershell-ის შიგნით .NET ობიექტის მოდელი სრულად არსებობს ერთ კომპიუტერში (ერთი OS), კოდის დისტანციურად გაშვებისას WSMAN-ის საშუალებით ობიექტების გადაცემა ხდება XML სერიულიზაციით, რაც დიდ დამატებით ინტერესს იწვევს. ჩვენს კვლევას. მოდით გავაგრძელოთ ჩვენი ექსპერიმენტები შემდეგი კოდის გაშვებით:

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

და ეს არის ის, რაც ჩვენ გვაქვს ეკრანზე:

Out to host.

ExitCode: 3

IsPublic IsSerial Name                                     BaseType
-------- -------- ----                                     --------
True     True     Object[]                                 System.Array
Не удается преобразовать аргумент "exitCode", со значением: "System.Object[]", для "SetShouldExit" в тип "System.Int32": "Не удается преобразовать значение "System.Object[]" типа "System.Object[]" в тип "System
.Int32"."
D:sqlagentTestOutput3.ps1:3 знак:1
+ $host.SetShouldExit($res)
+ ~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : NotSpecified: (:) [], MethodException
    + FullyQualifiedErrorId : MethodArgumentConversionInvalidCastArgument

ERRORLEVEL=0

შესანიშნავი შედეგი! ეს ნიშნავს, რომ Invoke-Command-ის გამოძახებისას შენარჩუნებულია მილსადენების დაყოფა ორ ძაფად (Host და Output), რაც წარმატების იმედს გვაძლევს. შევეცადოთ გამომავალი ნაკადში დავტოვოთ მხოლოდ ერთი მნიშვნელობა, რისთვისაც ჩვენ შევცვლით პირველივე სკრიპტს, რომელსაც დისტანციურად ვატარებთ:

$exitcode = $args[0]
Write-Host 'Out to host.'
#Write-Output 'Out to output.'
Write-Host ('ExitCode: ' + $exitcode)
Write-Output $exitcode
$host.SetShouldExit($exitcode)

მოდით გავუშვათ ასე:

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

და... დიახ, გამარჯვებას ჰგავს!

Out to host.
ExitCode: 4

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


ERRORLEVEL=4

შევეცადოთ გაერკვნენ, რა მოხდა. ჩვენ გამოვიძახეთ powershell ლოკალურად, რომელიც თავის მხრივ დისტანციურ კომპიუტერზე დარეკა powershell და იქ შეასრულა ჩვენი სკრიპტი. ორი ნაკადი (მასპინძელი და გამომავალი) დისტანციური აპარატიდან იყო სერიული და გადაეცა უკან, ხოლო გამომავალი ნაკადი, რომელსაც აქვს ერთი ციფრული მნიშვნელობა, გადაკეთდა Int32 ტიპად და, როგორც ასეთი, გადავიდა მიმღებ მხარეს, ხოლო მიმღები მხარე იყენებდა მას. როგორც აბონენტის Powershell-ის გასასვლელი კოდი.

და როგორც საბოლოო შემოწმება, მოდით შევქმნათ ერთსაფეხურიანი სამუშაო SQL სერვერზე ტიპის "ოპერაციული სისტემა (cmdexec)" შემდეგი ტექსტით:

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

ჰორი! დავალება შესრულებულია შეცდომით, ტექსტი ჟურნალში:

Выполняется от имени пользователя: DOMAINagentuser. Out to host. ExitCode: 6.  Код завершения процесса 6.  Шаг завершился с ошибкой.

დასკვნები:

• მოერიდეთ Write-Output-ის გამოყენებას და გამონათქვამების მითითებას მინიჭების გარეშე. გაითვალისწინეთ, რომ ამ კოდის გადატანა სკრიპტის სხვაგან შეიძლება გამოიწვიოს მოულოდნელი შედეგები.
• სკრიპტებში, რომლებიც განკუთვნილია არა ხელით გაშვებისთვის, არამედ თქვენს ავტომატიზაციის მექანიზმებში გამოსაყენებლად, განსაკუთრებით WINRM-ის დისტანციური ზარებისთვის, გააკეთეთ შეცდომების ხელით დამუშავება Try/Catch-ის საშუალებით და დარწმუნდით, რომ მოვლენების განვითარების ნებისმიერ დროს ეს სკრიპტი აგზავნის ზუსტად ერთ პრიმიტიულ ტიპის მნიშვნელობას. . თუ გსურთ მიიღოთ კლასიკური შეცდომის დონე, ეს მნიშვნელობა უნდა იყოს რიცხვითი.

წყარო: www.habr.com