다음을 통해 공유


PowerShellOnTargetMachines@2 - 대상 컴퓨터 v2 작업의 PowerShell

이 작업을 사용하여 원격 컴퓨터에서 PowerShell 스크립트를 실행합니다.

구문론

# PowerShell on Target Machines v2
# Execute PowerShell scripts on remote machine(s).
- task: PowerShellOnTargetMachines@2
  inputs:
    EnvironmentName: # string. Required. Machines. 
    #AdminUserName: # string. Admin Login. 
    #AdminPassword: # string. Password. 
    #Protocol: # 'Http' | 'Https'. Protocol. 
    #TestCertificate: true # boolean. Optional. Use when Protocol = Https. Test Certificate. Default: true.
  # Deployment
    ScriptPath: # string. Required. PowerShell Script. 
    #ScriptArguments: # string. Script Arguments. 
    #InitializationScriptPath: # string. Initialization Script. 
    #SessionVariables: # string. Session Variables. 
  # Advanced Options
    #RunPowershellInParallel: true # boolean. Run PowerShell in Parallel. Default: true.
    #ResourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Select Machines By. Default: machineNames.
    #MachineNames: # string. Filter Criteria.

입력

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

포트와 함께 컴퓨터 IP 주소 또는 FQDN의 쉼표로 구분된 목록을 지정합니다. 기본 포트는 선택한 프로토콜을 기반으로 합니다.
예: dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.12.34:5986
다른 작업의 출력 변수(예: $(variableName))를 제공할 수도 있습니다. HTTPS를 사용하는 경우 컴퓨터의 이름 또는 IP가 인증서의 CN과 일치해야 합니다.


AdminUserName - 관리자 로그인
string;

대상 컴퓨터에 대한 관리자 로그인을 지정합니다.
예: Domain\Admin User, Admin User@Domain, .\Admin User.


암호AdminPassword -
string;

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


Protocol - 프로토콜
string; 허용되는 값: Http, Https.

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


TestCertificate - 테스트 인증서
boolean; 선택 사항. Protocol = Https때 사용합니다. 기본값은 true입니다.

신뢰할 수 있는 인증 기관에서 컴퓨터 인증서의 인증 유효성 검사를 건너뛰는 옵션을 지정합니다. 이 매개 변수는 WinRM HTTPS 프로토콜에 필요합니다.


PowerShell 스크립트ScriptPath -
string; 필수 사항입니다.

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


ScriptArguments - 스크립트 인수
string;

PowerShell 스크립트의 인수를 지정합니다. -testParam 테스트와 같은 서수 또는 명명된 매개 변수일 수 있습니다.


InitializationScriptPath - 초기화 스크립트
string;

대상 컴퓨터 또는 UNC 경로(예: C:\BudgetIT\Web\Deploy\WebsiteConfiguration.ps1)에서 DSC에 대한 데이터 스크립트의 위치를 지정합니다.


세션 변수SessionVariables -
string;

두 스크립트에 대한 공통 세션 변수를 지정합니다. 예를 들어 $variable = value 또는 $var1 = "value, 123".


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

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


컴퓨터 선택 ResourceFilteringMethod -
string; 허용되는 값: machineNames(컴퓨터 이름), tags. 기본값은 machineNames입니다.

선택 사항. 컴퓨터 이름 또는 태그를 제공하여 컴퓨터의 하위 집합을 지정합니다.


필터 조건MachineNames -
string;

이 입력은 컴퓨터 그룹 또는 출력 변수에만 유효합니다. 아직 컴퓨터의 플랫 목록에 대해서는 지원되지 않습니다.

dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34같은 Role:DB; OS:Win8.1 또는 태그와 같은 컴퓨터 목록을 지정합니다. 여러 태그를 지정하면 지정된 태그가 있는 모든 컴퓨터에서 작업이 실행됩니다. 기본값은 모든 컴퓨터에서 작업을 실행합니다.


작업 제어 옵션

모든 작업에는 작업 입력 외에 제어 옵션이 있습니다. 자세한 내용은 컨트롤 옵션 및 일반적인 작업 속성참조하세요.

출력 변수

없음.

비고

버전 2.0의 새로운 기능:

  • 레거시 DTL 머신의 지원이 제거되었습니다.

요구 사항

요구 사항 설명
파이프라인 유형 YAML, 클래식 빌드, 클래식 릴리스
다음에서 실행 에이전트, DeploymentGroup
요구 없음
기능 이 작업은 작업의 후속 작업에 대한 요구 사항을 충족하지 않습니다.
명령 제한 어느 것이든
settable 변수 어느 것이든
에이전트 버전 1.104.0 이상
작업 범주 배치하다