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

To zadanie służy do wykonywania skryptów programu PowerShell na maszynach 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 - Machines
string. To jest 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ą CN w certyfikacie.

logowania administratora AdminUserName -
string.

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

haseł AdminPassword -
string.

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

protokołu Protocol -
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 - certyfikatu testowego
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. To jest 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 test -testParam.

skrypt inicjowania InitializationScriptPath -
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 - zmiennych 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 w równoległych
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 tagów, takich jak 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 zadaniami

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

Zmienne wyjściowe

Żaden.

Uwagi

Co nowego w wersji 2.0:

• Usunięto obsługę starszych maszyn DTL.

Wymagania

Wymaganie	Opis
Typy potoków	YAML, klasyczna kompilacja, wersja klasyczna
Działa na	Agent, DeploymentGroup
Wymagania	Żaden
możliwości	To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
ograniczenia poleceń	Jakikolwiek
zmienne ustawiane	Jakikolwiek
Wersja agenta	1.104.0 lub nowsza
Kategoria zadań	Wdroż