AzurePowerShell@4 – Azure PowerShell v4-feladat

Ezzel a feladatsal PowerShell-szkriptet futtathat egy Azure-környezetben. Az Azure-környezet hitelesítése a megadott Azure Resource Manager szolgáltatáskapcsolattal történik.

Syntax

# Azure PowerShell v4
# Run a PowerShell script within an Azure environment.
- task: AzurePowerShell@4
  inputs:
    azureSubscription: # string. Alias: ConnectedServiceNameARM. Required. Azure Subscription. 
    #ScriptType: 'FilePath' # 'FilePath' | 'InlineScript'. Script Type. Default: FilePath.
    #ScriptPath: # string. Optional. Use when ScriptType = FilePath. Script Path. 
    #Inline: # string. Optional. Use when ScriptType = InlineScript. Inline Script. 
    #ScriptArguments: # string. Optional. Use when ScriptType = FilePath. Script Arguments. 
    #errorActionPreference: 'stop' # 'stop' | 'continue' | 'silentlyContinue'. ErrorActionPreference. Default: stop.
    #FailOnStandardError: false # boolean. Fail on Standard Error. Default: false.
    #RestrictContextToCurrentTask: false # boolean. Restrict scope of context to current task. Default: false.
  # Azure PowerShell version options
    #azurePowerShellVersion: 'OtherVersion' # 'LatestVersion' | 'OtherVersion'. Alias: TargetAzurePs. Azure PowerShell Version. Default: OtherVersion.
    preferredAzurePowerShellVersion: # string. Alias: CustomTargetAzurePs. Required when TargetAzurePs = OtherVersion. Preferred Azure PowerShell Version. 
  # Advanced
    #pwsh: false # boolean. Use PowerShell Core. Default: false.
    #validateScriptSignature: false # boolean. Optional. Use when ScriptType = FilePath. Validate script signature. Default: false.
    #workingDirectory: # string. Working Directory.

Bevitelek

azureSubscription - Azure-előfizetés
Bemeneti alias: ConnectedServiceNameARM. string. Kötelező.

Az Azure Resource Manager-előfizetést, amely konfigurálható a PowerShell futtatása előtt.

ScriptType - Szkript típusa
string. Engedélyezett értékek: FilePath (Szkriptfájl elérési útja), InlineScript (beágyazott szkript). Alapértelmezett érték: FilePath.

A szkript típusa: fájl elérési útja vagy beágyazott.

ScriptPath - Szkript elérési útja
string. Választható. Használja a következőt: ScriptType = FilePath.

A szkript elérési útja. Ennek egy teljes elérési útnak kell lennie, vagy az alapértelmezett munkakönyvtárhoz viszonyítva.

Inline - Beágyazott szkript
string. Választható. Használja a következőt: ScriptType = InlineScript. Alapértelmezett érték: # You can write your azure powershell scripts inline here. \n# You can also pass predefined and custom variables to this script using arguments.

A végrehajtandó szkriptet spekulálja. A beágyazott szkript maximális támogatott hossza 5000 karakter. Használjon egy fájlból származó szkriptet, ha hosszabb szkriptet szeretne használni.

ScriptArguments - Szkriptargumentumok
string. Választható. Használja a következőt: ScriptType = FilePath.

A PowerShellnek továbbadandó további paraméterek. Lehet sorszám vagy elnevezett paraméter.

errorActionPreference - ErrorActionPreference
string. Engedélyezett értékek: stop, continue, silentlyContinue. Alapértelmezett érték: stop.

Kiválasztja a változó értékét a ErrorActionPreference szkript végrehajtásához.

FailOnStandardError - Hiba a standard hiba miatt
boolean. Alapértelmezett érték: false.

Ha ez igaz, ez a feladat sikertelen lesz, ha bármilyen hiba a hibafolyamatba van írva, vagy ha bármilyen adat a standard hibastreambe van írva.

RestrictContextToCurrentTask - A környezet hatókörének korlátozása az aktuális tevékenységre
boolean. Alapértelmezett érték: false.

Ha ez igaz, ez a tevékenység csak az aktuális tevékenységre korlátozza a környezet hatókörét, és privát ügynök használata esetén a környezet nem lesz elérhető a folyamat más tevékenységei számára.

azurePowerShellVersion - Azure PowerShell verzió
Bemeneti alias: TargetAzurePs. string. Engedélyezett értékek: LatestVersion (Legújabb telepített verzió), OtherVersion (Más verzió megadása). Alapértelmezett érték: OtherVersion.

Üzemeltetett ügynökök esetén a támogatott Azure PowerShell verzió: 1.0.0 (Üzemeltetett VS2017-üzenetsor). Az ügynökön elérhető legújabb verzió kiválasztásához válassza a (Legújabb telepített verzió) lehetőséget LatestVersion .

Magánügynökök esetén megadhatja a Azure PowerShell előnyben részesített verzióját a használatával OtherVersion (Más verzió megadása).

preferredAzurePowerShellVersion - Előnyben részesített Azure PowerShell verzió
Bemeneti alias: CustomTargetAzurePs. string. Akkor szükséges, ha TargetAzurePs = OtherVersion.

Az előnyben részesített Azure PowerShell verziónak megfelelő szemantikai verziónak kell lennie, például. 1.2.3. A Regex like 2.\*,2.3.\* nem támogatott. A üzemeltetett VS2017-készlet jelenleg az Az modulverziót támogatja 1.0.0.

pwsh - A PowerShell Core használata
boolean. Alapértelmezett érték: false.

Ha ez igaz, akkor Windows rendszeren a feladat az elérési útból lesz használva pwsh.exe a helyett powershell.exe.

validateScriptSignature - Szkript aláírásának ellenőrzése
boolean. Választható. Használja a következőt: ScriptType = FilePath. Alapértelmezett érték: false.

Ha ez igaz, akkor a feladat először ellenőrzi, hogy a megadott szkript aláírása és érvényes-e a végrehajtása előtt.

workingDirectory - Munkakönyvtár
string.

A munkakönyvtár, ahol a szkript fut.

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

Az Az Module és a platformfüggetlen ügynökök támogatása hozzáadva.

Követelmények

Követelmény	Leírás
Folyamattípusok	YAML, klasszikus build, klasszikus kiadás
Futtatás:	Ügynök, DeploymentGroup
Igények	None
Képességek	Ez a tevékenység 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	2.115.0 vagy újabb
Feladatkategória	Üzembe helyezés