পাওয়ারশেল ইনভোক-কমান্ড থেকে SQL সার্ভার এজেন্টে একটি মান ফেরত দেওয়া হচ্ছে

একাধিক 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]

এটি আরও আকর্ষণীয়। আউটপুটে বার্তাটি কোথাও অদৃশ্য হয়ে গেছে:

Out to host.
ExitCode: 2
ERRORLEVEL=0

এখন, একটি লিরিক্যাল ডিগ্রেশন হিসাবে, আমি লক্ষ্য করব যে যদি একটি পাওয়ারশেল ফাংশনের ভিতরে আপনি লিখুন-আউটপুট বা শুধুমাত্র একটি অভিব্যক্তি লিখুন যেটি কোনো ভেরিয়েবলের সাথে বরাদ্দ না করে (এবং এটি আউটপুট চ্যানেলে আউটপুটকে বোঝায়), তারপরও স্থানীয়ভাবে চালানোর সময়ও, কিছুই পর্দায় প্রদর্শিত হবে না! এটি পাওয়ারশেল পাইপলাইন আর্কিটেকচারের একটি পরিণতি - প্রতিটি ফাংশনের নিজস্ব আউটপুট পাইপলাইন থাকে, এটির জন্য একটি অ্যারে তৈরি করা হয় এবং এতে যা কিছু যায় তা ফাংশন সম্পাদনের ফলাফল হিসাবে বিবেচিত হয়, রিটার্ন অপারেটর একই সাথে রিটার্ন মান যোগ করে পাইপলাইন শেষ উপাদান হিসাবে এবং কলিং ফাংশনে নিয়ন্ত্রণ স্থানান্তর করে। ব্যাখ্যা করার জন্য, আসুন স্থানীয়ভাবে নিম্নলিখিত স্ক্রিপ্টটি চালাই:

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

প্রধান ফাংশন (স্ক্রিপ্ট বডি) এর নিজস্ব আউটপুট পাইপলাইন রয়েছে এবং যদি আমরা সিএমডি থেকে প্রথম স্ক্রিপ্ট চালাই, আউটপুটটিকে একটি ফাইলে পুনঃনির্দেশ করে,

PowerShell .TestOutput1.ps1 1 > TestOutput1.txt

তারপর আমরা পর্দায় দেখতে পাব

ERRORLEVEL=1

এবং ফাইলে

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

যদি আমরা পাওয়ারশেল থেকে অনুরূপ কল করি

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

তারপর এটি পর্দায় হবে

Out to host.
ExitCode: 1

এবং ফাইলে

Out to output.
1

এটি ঘটে কারণ সিএমডি পাওয়ারশেল চালু করে, যা অন্যান্য নির্দেশাবলীর অনুপস্থিতিতে দুটি থ্রেড (হোস্ট এবং আউটপুট) মিশ্রিত করে এবং সেগুলি সিএমডিকে দেয়, যা এটি প্রাপ্ত সমস্ত কিছু একটি ফাইলে পাঠায় এবং পাওয়ারশেল থেকে চালু করার ক্ষেত্রে, এই দুটি থ্রেড আলাদাভাবে বিদ্যমান, এবং প্রতীক পুনঃনির্দেশ শুধুমাত্র আউটপুটকে প্রভাবিত করে।

মূল বিষয়ে ফিরে আসা, আমাদের মনে রাখা যাক যে পাওয়ারশেলের ভিতরে .NET অবজেক্ট মডেলটি সম্পূর্ণরূপে একটি কম্পিউটারের মধ্যে বিদ্যমান (একটি ওএস), যখন 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

দুর্দান্ত ফলাফল! এর মানে হল ইনভোক-কমান্ড কল করার সময়, পাইপলাইনগুলির দুটি থ্রেডে (হোস্ট এবং আউটপুট) বিভাজন বজায় রাখা হয়, যা আমাদের সাফল্যের আশা দেয়। আসুন আউটপুট স্ট্রীমে শুধুমাত্র একটি মান ছেড়ে দেওয়ার চেষ্টা করি, যার জন্য আমরা দূরবর্তীভাবে চালানো প্রথম স্ক্রিপ্টটি পরিবর্তন করব:

$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

কি ঘটেছে তা বের করার চেষ্টা করা যাক। আমরা স্থানীয়ভাবে পাওয়ারশেলকে কল করেছিলাম, যা রিমোট কম্পিউটারে পাওয়ারশেলকে কল করে এবং সেখানে আমাদের স্ক্রিপ্টটি কার্যকর করে। রিমোট মেশিন থেকে দুটি স্ট্রীম (হোস্ট এবং আউটপুট) সিরিয়ালাইজ করা হয়েছিল এবং পিছনে পাস করা হয়েছিল, যখন আউটপুট স্ট্রীম, এতে একটি একক ডিজিটাল মান রয়েছে, টাইপ Int32 তে রূপান্তরিত হয়েছিল এবং এইভাবে প্রাপ্তির দিকে চলে গিয়েছিল এবং গ্রহণকারী পক্ষ এটি ব্যবহার করেছিল। কলার পাওয়ারশেলের প্রস্থান কোড হিসাবে।

এবং চূড়ান্ত পরীক্ষা হিসেবে, তৈরি করা যাক সার্ভার "অপারেটিং সিস্টেম (cmdexec)" ধরণের একটি একক-পদক্ষেপ SQL টাস্ক যার লেখাটি নিম্নোক্ত:

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.  Шаг завершился с ошибкой.

সিদ্ধান্তে:

• লিখুন-আউটপুট ব্যবহার করা এড়িয়ে চলুন এবং অ্যাসাইনমেন্ট ছাড়া এক্সপ্রেশন নির্দিষ্ট করুন। সচেতন থাকুন যে এই কোডটি স্ক্রিপ্টের অন্য কোথাও সরানো হলে অপ্রত্যাশিত ফলাফল হতে পারে।
• ম্যানুয়াল লঞ্চের জন্য নয়, কিন্তু আপনার অটোমেশন মেকানিজমগুলিতে ব্যবহারের জন্য বিশেষত WINRM-এর মাধ্যমে দূরবর্তী কলগুলির জন্য স্ক্রিপ্টগুলিতে, চেষ্টা করুন/ক্যাচের মাধ্যমে ম্যানুয়াল ত্রুটি পরিচালনা করুন এবং নিশ্চিত করুন যে, ইভেন্টের যেকোনো বিকাশে, এই স্ক্রিপ্টটি ঠিক একটি আদিম ধরনের মান পাঠায়। . আপনি যদি ক্লাসিক ত্রুটির স্তর পেতে চান তবে এই মানটি অবশ্যই সাংখ্যিক হতে হবে।

উত্স: www.habr.com