PowerShellOnTargetMachines@1 – Úloha PowerShellu na cílových počítačích v1

Článek
07/02/2024

Pomocí této úlohy můžete spouštět skripty PowerShellu na vzdálených počítačích.

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.

Vstupy

EnvironmentName - Stroje
string. Povinná hodnota.

Určuje čárkami oddělený seznam IP adres počítačů nebo plně kvalifikovaných názvů domén spolu s porty. Výchozí port je založený na vybraném protokolu.
Příklad: dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.12.34:5986
Můžete také zadat výstupní proměnnou jiných úkolů, například $(variableName). Pokud používáte HTTPS, název nebo IP adresa počítače by se měla shodovat s CN v certifikátu.

AdminUserName - přihlášení Správa
string.

Určuje přihlášení správce pro cílové počítače.

AdminPassword - Heslo
string.

Určuje heslo správce pro cílové počítače. Proměnné definované v definicích sestavení/verze jako $(passwordVariable) jsou přijímány. Typ proměnné můžete označit jako secret zabezpečený.

Protocol - Protokol
string. Povolené hodnoty: Http, Https.

Určuje protokol, který se má použít pro připojení WinRM k počítačům. Výchozí hodnota je HTTPS.

TestCertificate - Test certifikátu
boolean. Nepovinný parametr. Použijte, když Protocol = Https. Výchozí hodnota: true.

Přeskočí ověření pravosti certifikátu počítače důvěryhodnou certifikační autoritou. Parametr se vyžaduje pro protokol HTTPS WinRM.

ScriptPath - Skript PowerShellu
string. Povinná hodnota.

Určuje umístění skriptu PowerShellu na cílových počítačích nebo v cestě UNC, například C:\BudgetIT\Web\Deploy\Website.ps1.

ScriptArguments - Argumenty skriptu
string.

Určuje argumenty pro skript PowerShellu. Může to být pořadové číslo nebo pojmenované parametry, jako je -testParam test.

InitializationScriptPath - Inicializační skript
string.

Určuje umístění datového skriptu pro DSC na cílových počítačích nebo v cestě UNC, například C:\BudgetIT\Web\Deploy\WebsiteConfiguration.ps1.

SessionVariables - Proměnné relace
string.

Určuje společné proměnné relace pro oba skripty. Příkladem je $variable = value nebo $var1 = "value, 123".

RunPowershellInParallel - Paralelní spuštění PowerShellu
boolean. Výchozí hodnota: true.

Pokud je nastavená hodnota true, spouští skripty PowerShellu paralelně na cílových počítačích.

ResourceFilteringMethod - Vybrat počítače podle
string. Povolené hodnoty: machineNames (názvy počítačů), tags. Výchozí hodnota: machineNames.

Nepovinný parametr. Určuje podmnožinu počítačů zadáním názvů počítačů nebo značek.

MachineNames - Kritéria filtru
string.

Tento vstup je platný pouze pro skupiny počítačů nebo výstupní proměnné. U plochého seznamu počítačů se zatím nepodporuje.

Určuje seznam počítačů, například dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34 nebo značek, například Role:DB; OS:Win8.1. Pokud je zadáno více značek, úloha se spustí na všech počítačích se zadanými značkami. Ve výchozím nastavení se úloha spouští na všech počítačích.

Možnosti ovládání úloh

Všechny úlohy mají kromě vstupů také možnosti ovládání. Další informace najdete v tématu Možnosti ovládacích prvků a běžné vlastnosti úlohy.

Výstupní proměnné

Žádné

Požadavky

Požadavek	Popis
Typy kanálů	YAML, klasický build, klasická verze
Běží na	Agent, DeploymentGroup
Požadavky	Žádné
Možnosti	Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
Omezení příkazů	Všechny
Nastavitelné proměnné	Všechny
Verze agenta	1.104.0 nebo vyšší
Kategorie úloh	Nasazení

Sdílet prostřednictvím