Megosztás a következőn keresztül:

PowerShell@1 – PowerShell v1-feladat

  • Cikk

Futtasson egy PowerShell-szkriptet.

Szintaxis

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

Bevitelek

scriptType - Típus
string. Kötelező. Engedélyezett értékek: inlineScript (beágyazott szkript), filePath (Fájl elérési útja). Alapértelmezett érték: filePath.

Megadja a futtatandó feladat szkripttípusát: beágyazott szkriptet vagy egy .ps1 fájl elérési útját.


scriptName - Szkript elérési útja
string. Akkor szükséges, ha scriptType = filePath.

Megadja a futtatandó feladat szkripttípusát: beágyazott szkriptet vagy egy .ps1 fájl elérési útját.


arguments - Érvek
string.

Megadja a PowerShell-szkriptnek átadott argumentumokat. Az argumentumok lehetnek sorszámparaméterek vagy névvel ellátott paraméterek. Például: -Name someName -Path -Value "Some long string value".

arguments nem használatos, ha targetType a értéke inline.


workingFolder - Munkamappa
string.

Megadja azt a munkakönyvtárat, amelyen a szkript fut. Ha nincs megadva érték, a munkakönyvtár a következő $(Build.SourcesDirectory): .


inlineScript - Beágyazott szkript
string. Akkor szükséges, ha scriptType = inlineScript. Alapértelmezett érték: # 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".

Megadja a szkript tartalmát. A beágyazott parancsfájlok maximális támogatott hossza 500 karakter. Használjon szkriptet egy fájlból, ha hosszabb szkriptet szeretne használni.


failOnStandardError - Hiba standard hiba miatt
boolean. Alapértelmezett érték: true.

Ha ennek a logikai trueértéknek az értéke , a feladat meghiúsul, ha bármilyen hibát a hibafolyamatba ír, vagy ha bármilyen adat a Standard hibafolyamba van írva. Ellenkező esetben a feladat a kilépési kódra támaszkodik a hiba meghatározásához.


Feladatvezérlési lehetőségek

Minden feladathoz tartoznak vezérlési lehetőségek is a feladat bemenetei mellett. További információ: Vezérlési beállítások és gyakori feladattulajdonságok.

Kimeneti változók

Nincsenek.

Megjegyzések

PowerShell@1 csak Windows-ügynökökön fut. A PowerShell más ügynöktípusokon való futtatásához használja a PowerShell@2.

Minden PowerShell-munkamenet csak annak a feladatnak az időtartamára tart, amelyben fut. A rendszerindítótól függő feladatoknak ugyanabban a feladatban kell lenniük, mint a bootstrapnak.

Állítson be egy változót, hogy az a későbbi szkriptek és feladatok alapján olvasható legyen

A buildváltozók szkriptben való definiálásáról további információt A buildváltozók definiálása és módosítása szkriptben című témakörben talál.

A kiadási változók szkriptben való definiálásáról további információt a Kiadási változók definiálása és módosítása szkriptben című témakörben talál.

A folyamat titkos kulcsainak átadása szkriptben, de a titkos kód nem maszkolva van a folyamatnaplókban

Vegye figyelembe, hogy a PowerShell levágja a hibaüzeneteket, így ha folyamat titkos kódokat használ egy szkriptben, a titkos kódokat levághatja és közzéteheti. Például az alábbi beágyazott szkriptben:

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

A következőhöz hasonló kivétel lehet: At <path_to_temp_script_file>:4 char:3

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

A probléma elkerülése érdekében szkriptszinten kezelheti ezeket a kivételeket, vagy elkerülheti azokat az eseteket, amikor a folyamat titkos kódjai megjelenhetnek a forráskódsorokban a hibaüzenetekben.

Követelmények

Követelmény Leírás
Folyamattípusok YAML, klasszikus build, klasszikus kiadás
Futtatás Ügynök, DeploymentGroup
Igények A saját üzemeltetésű ügynököknek olyan képességekkel kell rendelkezniük , amelyek megfelelnek az alábbi követelményeknek a feladatot használó feladatok futtatásához: DotNetFramework
Képességek Ez a feladat nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek.
Parancskorlátozások Bármelyik
Változók beállítása Bármelyik
Ügynök verziója 1.102 vagy újabb
Feladatkategória Segédprogram

Lásd még