다음을 통해 공유

PowerShellOnTargetMachines@1 - 대상 컴퓨터 v1 작업의 PowerShell

  • 아티클

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

Syntax

# PowerShell on Target Machines v1
# Execute PowerShell scripts on remote machine(s).
- task: PowerShellOnTargetMachines@1
  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.

대상 머신에 대한 관리자 로그인을 지정합니다.


AdminPassword - 암호
string.

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


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

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


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

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


ScriptPath - PowerShell 스크립트
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.

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

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


작업 제어 옵션

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

출력 변수

없음

요구 사항

요구 사항 Description
파이프라인 유형 YAML, 클래식 빌드, 클래식 릴리스
실행 중 에이전트, DeploymentGroup
요청 없음
Capabilities 이 작업은 작업의 후속 작업에 대한 요구를 충족하지 않습니다.
명령 제한 사항 모두
설정 가능한 변수 모두
에이전트 버전 1.104.0 이상
작업 범주 배포