Udostępnij przez

PowerShell@1 — zadanie programu PowerShell w wersji 1

Uruchom skrypt programu PowerShell.

Składnia

# PowerShell v1
# Run a PowerShell script.
- task: PowerShell@1
  inputs:
    scriptType: 'filePath' # 'inlineScript' | 'filePath'. Required. Type. Default: filePath.
    scriptName: # string. Required when scriptType = filePath. Script Path. 
    #arguments: # string. Arguments. 
    #inlineScript: # string. Required when scriptType = inlineScript. Inline Script. 
  # Advanced
    #workingFolder: # string. Working folder. 
    #failOnStandardError: true # boolean. Fail on Standard Error. Default: true.

Dane wejściowe

scriptType - typ
string. To jest wymagane. Dozwolone wartości: inlineScript (Skrypt wbudowany), filePath (Ścieżka pliku). Wartość domyślna: filePath.

Określa typ skryptu dla zadania do uruchomienia: skrypt wbudowany lub ścieżka .ps1 do pliku.


scriptName - ścieżka skryptu
string. Wymagane, gdy scriptType = filePath.

Określa typ skryptu dla zadania do uruchomienia: skrypt wbudowany lub ścieżka .ps1 do pliku.


arguments - argumenty
string.

Określa argumenty przekazywane do skryptu programu PowerShell. Argumenty mogą być parametrami porządkowymi lub parametrami nazwanymi. Na przykład -Name someName -Path -Value "Some long string value".

arguments nie jest używany, gdy targetType jest ustawiony na inline.


workingFolder - folder roboczy
string.

Określa katalog roboczy, w którym jest uruchamiany skrypt. Jeśli wartość nie zostanie określona, katalogiem roboczym będzie $(Build.SourcesDirectory).


skryptu wbudowanego
string. Wymagane, gdy scriptType = inlineScript. Wartość domyślna: # You can write your powershell scripts inline here. \n# You can also pass predefined and custom variables to this scripts using arguments\n\n Write-Host "Hello World".

Określa zawartość skryptu. Maksymalna obsługiwana długość skryptu wbudowanego to 500 znaków. Użyj skryptu z pliku, jeśli chcesz użyć dłuższego skryptu.


failOnStandardError - niepowodzenie w błędu standardowego
boolean. Wartość domyślna: true.

Jeśli wartość tej wartości logicznej to true, zadanie kończy się niepowodzeniem, jeśli jakiekolwiek błędy zostaną zapisane w potoku błędów lub jeśli jakiekolwiek dane zostaną zapisane w strumieniu błędów standardowych. W przeciwnym razie zadanie opiera się na kodzie zakończenia w celu określenia błędu.


Opcje sterowania zadania

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

PowerShell@1 działa tylko na agentach systemu Windows. Aby uruchomić program PowerShell na innych typach agentów, użyj PowerShell@2.

Każda sesja programu PowerShell trwa tylko przez czas trwania zadania, w którym jest uruchamiana. Zadania zależne od bootstrap muszą znajdować się w tym samym zadaniu co bootstrap.

Ustaw zmienną, aby mogła być odczytywana przez kolejne skrypty i zadania

Aby dowiedzieć się więcej na temat definiowania zmiennych kompilacji w skrypcie, zobacz Definiowanie i modyfikowanie zmiennych kompilacji w skrypcie.

Aby dowiedzieć się więcej na temat definiowania zmiennych wydania w skrypcie, zobacz Definiowanie i modyfikowanie zmiennych wydania w skrypcie.

Przekazywanie wpisów tajnych potoku w skrypcie, ale wpis tajny nie jest maskowany w dziennikach potoku

Należy pamiętać, że program PowerShell odcina komunikaty o błędach, więc jeśli używasz wpisów tajnych potoku w skrypcie, wpisy tajne mogą zostać przycięte i uwidocznione. Na przykład w poniższym skrypcie wbudowanym:

./script.ps1 --arg1 value1 --arg2 <some_secret_which_will_be_masked_here>

Może istnieć wyjątek taki jak: At <path_to_temp_script_file>:4 char:3

+   ./script.ps1 --arg1 value1 --arg2 <unmasked_part_of_original_secret> ...
+   ~~~~~~~~~~
    + <Additional exception details>

Aby uniknąć tego problemu, można obsłużyć te wyjątki na poziomie skryptu lub uniknąć przypadków, w których wpisy tajne potoku mogą pojawiać się w wierszach kodu źródłowego w komunikatach o błędach.

Wymagania

Wymaganie Opis
Typy potoków YAML, klasyczna kompilacja, wersja klasyczna
Działa na Agent, DeploymentGroup
Wymagania Agenci hostowani samodzielnie muszą mieć możliwości zgodne z następującymi wymaganiami , aby uruchamiać zadania korzystające z tego zadania: DotNetFramework
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.102 lub lepsza
Kategoria zadań Użyteczność

Zobacz także

  • Last updated on