powershell 호출 명령에서 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]

이것은 훨씬 더 흥미 롭습니다. 출력의 메시지가 어딘가에서 사라졌습니다.

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가 다른 명령이 없는 경우 두 개의 스레드(호스트 및 출력)를 혼합하여 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의 종료 코드로.

마지막 확인으로 다음 텍스트를 사용하여 "운영 체제(cmdexec)" 유형을 사용하여 SQL 서버에서 XNUMX단계 작업을 생성해 보겠습니다.

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를 통해 수동 오류 처리를 수행하고 이벤트 개발 시 이 스크립트가 정확히 하나의 기본 유형 값을 전송하는지 확인하세요. . 전형적인 Errorlevel을 얻으려면 이 값은 숫자여야 합니다.

출처 : habr.com