PowerShellOnTargetMachines@3 - 대상 컴퓨터 v3 작업의 PowerShell

이 작업을 사용하여 원격에 대한 PSSession 및 Invoke-Command 사용하여 원격 머신에서 PowerShell 스크립트를 실행합니다.

# PowerShell on target machines v3
# Execute PowerShell scripts on remote machines using PSSession and Invoke-Command for remoting.
- task: PowerShellOnTargetMachines@3
  inputs:
    Machines: # string. Required. Machines. 
    #UserName: # string. Username. 
    #UserPassword: # string. Password. 
  # Script options
    #ScriptType: 'Inline' # 'FilePath' | 'Inline'. Script Type. Default: Inline.
    #ScriptPath: # string. Required when ScriptType = FilePath. Script File Path. 
    InlineScript: # string. Required when ScriptType = Inline. Script. 
    #ScriptArguments: # string. Optional. Use when ScriptType = FilePath. Script Arguments. 
    #InitializationScript: # string. Optional. Use when ScriptType = FilePath. Initialization script. 
    #SessionVariables: # string. Optional. Use when ScriptType = FilePath. Session Variables. 
  # PSSession options
    #CommunicationProtocol: 'Https' # 'Http' | 'Https'. Protocol. Default: Https.
    #AuthenticationMechanism: 'Default' # 'Default' | 'Credssp'. Authentication. Default: Default.
    #NewPsSessionOptionArguments: '-SkipCACheck -IdleTimeout 7200000 -OperationTimeout 0 -OutputBufferingMode Block' # string. Session Option parameters. Default: -SkipCACheck -IdleTimeout 7200000 -OperationTimeout 0 -OutputBufferingMode Block.
  # Error handling options
    #ErrorActionPreference: 'stop' # 'stop' | 'continue' | 'silentlyContinue'. ErrorActionPreference. Default: stop.
    #failOnStderr: false # boolean. Fail on Standard Error. Default: false.
    #ignoreLASTEXITCODE: false # boolean. Ignore $LASTEXITCODE. Default: false.
  # Advanced
    #WorkingDirectory: # string. Working Directory. 
    #RunPowershellInParallel: true # boolean. Run PowerShell in Parallel. Default: true.

컴퓨터Machines -
string; 필수 사항입니다.

컴퓨터 FQDN 또는 IP 주소의 쉼표로 구분된 목록을 지정하고 필요에 따라 포트 번호를 포함합니다. 다음이 될 수 있습니다.

• Azure 리소스 그룹이름입니다.
• 컴퓨터 이름의 쉼표로 구분된 목록입니다. 예: dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.34:5986
• 이전 작업의 출력 변수입니다.

포트를 지정하지 않으면 기본 WinRM 포트가 사용됩니다. 이는 구성한 프로토콜에 따라 달라집니다. WinRM 2.0의 경우 기본 HTTP 포트는 5985 기본 HTTPS 포트는 5986.

사용자 이름UserName -
string;

대상 호스트의 도메인 또는 로컬 관리 계정의 사용자 이름을 지정합니다.

• username, domain\username, machine-name\username및 .\username 같은 형식이 지원됩니다.
• username@domain.com 같은 UPN 형식과 NT Authority\System 같은 기본 제공 시스템 계정은 지원되지 않습니다.

암호UserPassword -
string;

대상 컴퓨터의 암호를 지정합니다. $(passwordVariable) 빌드/릴리스 정의에 정의된 변수가 허용됩니다. 변수 형식을 secret 표시하여 보호할 수 있습니다.

ScriptType - 스크립트 형식
string; 허용되는 값: FilePath(파일 경로), Inline. 기본값은 Inline입니다.

실행할 스크립트 유형(인라인 또는 파일 경로)을 지정합니다.

ScriptPath - 스크립트 파일 경로
string; ScriptType = FilePath때 필요합니다.

대상 컴퓨터 또는 UNC 경로(예: 대상 컴퓨터에서 액세스할 수 있어야 하는 C:\BudgetIT\Web\Deploy\Website.ps1)에서 PowerShell 스크립트의 위치를 지정합니다.

InlineScript - 스크립트
string; ScriptType = Inline때 필요합니다. 기본값은 # Write your powershell commands here.\n\nWrite-Output "Hello World"입니다.

ScriptArguments - 스크립트 인수
string; 선택 사항. ScriptType = FilePath때 사용합니다.

PowerShell 스크립트의 인수를 지정합니다. -testParam 테스트와 같은 서수 또는 명명된 매개 변수일 수 있습니다. 예: -applicationPath $(applicationPath), -username $(vmusername), -password $(vmpassword).

InitializationScript - 초기화 스크립트
string; 선택 사항. ScriptType = FilePath때 사용합니다.

대상 컴퓨터 또는 UNC 경로(예: C:\BudgetIT\Web\Deploy\WebsiteConfiguration.ps1)에서 DSC에 대한 데이터 스크립트의 위치를 지정합니다. 초기화 스크립트 대신 인수를 사용하는 것이 좋습니다.

세션 변수SessionVariables -
string; 선택 사항. ScriptType = FilePath때 사용합니다.

PowerShell 스크립트에 대한 세션 변수를 설정하는 데 사용됩니다.
쉼표로 구분된 목록(예: $varx=valuex, $vary=valuey)을 지정합니다. 이전 버전의 릴리스 서비스와의 호환성을 위해 가장 일반적으로 사용됩니다. 세션 변수 대신 인수를 사용하는 것이 좋습니다.

CommunicationProtocol - 프로토콜
string; 허용되는 값: Http, Https. 기본값은 Https입니다.

컴퓨터와의 WinRM 서비스 연결에 사용할 프로토콜을 지정합니다. 기본값은 HTTPS입니다.

AuthenticationMechanism - 인증
string; 허용되는 값: Default, Credssp. 기본값은 Default입니다.

PSSession을 만드는 데 사용되는 인증 메커니즘을 지정합니다. CredSSP 인증의 경우 사용자 이름 및 암호 필드는 필수입니다.

세션 옵션 매개 변수NewPsSessionOptionArguments -
string; 기본값은 -SkipCACheck -IdleTimeout 7200000 -OperationTimeout 0 -OutputBufferingMode Block입니다.

원격 세션(New-PSSessionOption)에 대한 고급 옵션입니다. 예를 들어 -SkipCACheck, -SkipCNCheck, -SkipRevocationCheck등입니다. 자세한 내용은 모든 세션 옵션의 전체 목록을 참조하세요.

ErrorActionPreference - ErrorActionPreference
string; 허용되는 값: stop, continue, silentlyContinue. 기본값은 stop입니다.

스크립트 맨 위에 줄 $ErrorActionPreference = 'VALUE' 앞에 추가합니다.

표준 오류failOnStderr - 실패
boolean; 기본값은 false입니다.

true설정하면 오류 파이프라인에 오류가 기록되거나 표준 오류 스트림에 데이터가 기록되는 경우 실패합니다. 그렇지 않으면 태스크는 종료 코드를 사용하여 오류를 확인합니다.

ignoreLASTEXITCODE - 무시 $LASTEXITCODE
boolean; 기본값은 false입니다.

false설정하면 스크립트의 끝에서 줄 if ((Test-Path -LiteralPath variable:\LASTEXITCODE)) { exit $LASTEXITCODE } 실행됩니다. 이렇게 하면 외부 명령의 마지막 종료 코드가 PowerShell의 종료 코드로 전파됩니다. 그렇지 않으면 줄이 스크립트의 끝까지 실행되지 않습니다.

WorkingDirectory - 작업 디렉터리
string;

스크립트가 실행되는 작업 디렉터리를 지정합니다.

RunPowershellInParallel - 병렬 PowerShell 실행
boolean; 기본값은 true입니다.

true설정하면 대상 컴퓨터에서 PowerShell 스크립트를 병렬로 실행합니다.

없음.