PowerShellOnTargetMachines@1 — zadanie programu PowerShell na maszynach docelowych w wersji 1

Artykuł
07/02/2024

To zadanie służy do wykonywania skryptów programu PowerShell na maszynach zdalnych.

Składnia

# 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.

Dane wejściowe

EnvironmentName - Maszyny
string. Wymagane.

Określa rozdzielaną przecinkami listę adresów IP maszyny lub nazw FQDN wraz z portami. Port domyślny jest oparty na wybranym protokole.
Na przykład: dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.12.34:5986
Można również podać zmienną wyjściową innych zadań, na przykład $(variableName). Jeśli używasz protokołu HTTPS, nazwa lub adres IP maszyny powinny być zgodne z nazwą pospolitą w certyfikacie.

AdminUserName - logowanie Administracja
string.

Określa identyfikator logowania administratora dla maszyn docelowych.

AdminPassword - Hasło
string.

Określa hasło administratora dla maszyn docelowych. Zmienne zdefiniowane w definicjach kompilacji/wydania są $(passwordVariable) akceptowane. Możesz oznaczyć typ zmiennej jako secret , aby ją zabezpieczyć.

Protocol - Protokół
string. Dozwolone wartości: Http, Https.

Określa protokół, który ma być używany dla połączenia usługi WinRM z maszynami. Wartość domyślna to HTTPS.

TestCertificate - Certyfikat testowy
boolean. Opcjonalny. Użyj polecenia , gdy Protocol = Https. Wartość domyślna: true.

Pomija weryfikowanie autentyczności certyfikatu maszyny przez zaufany urząd certyfikacji. Parametr jest wymagany dla protokołu HTTPS usługi WinRM.

ScriptPath - Skrypt programu PowerShell
string. Wymagane.

Określa lokalizację skryptu programu PowerShell na maszynach docelowych lub w ścieżce UNC, na przykład C:\BudgetIT\Web\Deploy\Website.ps1.

ScriptArguments - Argumenty skryptu
string.

Określa argumenty skryptu programu PowerShell. Mogą być porządkowe lub nazwane parametry, takie jak -testParam test.

InitializationScriptPath - Skrypt inicjowania
string.

Określa lokalizację skryptu danych dla rozszerzenia DSC na maszynach docelowych lub w ścieżce UNC, na przykład C:\BudgetIT\Web\Deploy\WebsiteConfiguration.ps1.

SessionVariables - Zmienne sesji
string.

Określa wspólne zmienne sesji dla obu skryptów. Na przykład: $variable = value lub $var1 = "value, 123".

RunPowershellInParallel - Uruchamianie programu PowerShell równolegle
boolean. Wartość domyślna: true.

Jeśli ustawiono wartość true, uruchamia skrypty programu PowerShell równolegle na maszynach docelowych.

ResourceFilteringMethod - Wybierz maszyny według
string. Dozwolone wartości: machineNames (nazwy maszyn), tags. Wartość domyślna: machineNames.

Opcjonalny. Określa podzbiór maszyn, podając nazwy maszyn lub tagi.

MachineNames - Kryteria filtrowania
string.

Te dane wejściowe są prawidłowe tylko dla grup maszyn lub zmiennych wyjściowych. Nie jest jeszcze obsługiwana w przypadku płaskiej listy maszyn.

Określa listę maszyn, takich jak dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34 lub tagi, na przykład Role:DB; OS:Win8.1. Jeśli określono wiele tagów, zadanie zostanie uruchomione na wszystkich maszynach z określonymi tagami. Domyślnie uruchamia zadanie na wszystkich maszynach.

Opcje sterowania zadania

Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań. Aby uzyskać więcej informacji, zobacz Opcje sterowania i typowe właściwości zadań.

Zmienne wyjściowe

Brak.

Wymagania

Wymaganie	Opis
Typy potoków	YAML, klasyczna kompilacja, wersja klasyczna
Działa w	Agent, DeploymentGroup
Wymagania	Brak
Możliwości	To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
Ograniczenia poleceń	Dowolne
Zmienne ustawialne	Dowolne
Wersja agenta	1.104.0 lub nowszy
Kategoria zadania	Wdrażanie

Udostępnij za pośrednictwem