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

Artykuł
07/02/2024

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

Składnia

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

Dane wejściowe

EnvironmentName - Maszyny
string. Wymagane.

Określa rozdzielaną przecinkami listę adresów IP maszyny lub nazw FQDN wraz z portami. Domyślny port jest oparty na wybranym protokole.
Na przykład: dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.12.34:5986
Możesz 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ą CN w certyfikacie.

AdminUserName - logowanie Administracja
string.

Określa identyfikator logowania administratora dla maszyn docelowych.
Na przykład: Domain\Admin User, , .\Admin UserAdmin User@Domain.

AdminPassword - Hasło
string.

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

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

Określa protokół używany do 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.

Określa opcję pomijania weryfikacji 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 - Wybieranie maszyn według
string. Dozwolone wartości: machineNames (nazwy maszyn), tags. Wartość domyślna: machineNames.

Opcjonalny. Określa podzestaw 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. Wartość domyślna uruchamia zadanie na wszystkich maszynach.

Opcje sterowania zadaniami

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

Zmienne wyjściowe

Brak.

Uwagi

Co nowego w wersji 2.0:

Usunięto obsługę starszych maszyn DTL.

Wymagania

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

Udostępnij za pośrednictwem