AzurePowerShell@3 – Azure PowerShell v3-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 v3
# Run a PowerShell script within an Azure environment.
- task: AzurePowerShell@3
  inputs:
    #azureConnectionType: 'ConnectedServiceNameARM' # 'ConnectedServiceName' | 'ConnectedServiceNameARM'. Alias: ConnectedServiceNameSelector. Azure Connection Type. Default: ConnectedServiceNameARM.
    #azureClassicSubscription: # string. Alias: ConnectedServiceName. Required when ConnectedServiceNameSelector = ConnectedServiceName. Azure Classic Subscription. 
    azureSubscription: # string. Alias: ConnectedServiceNameARM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM. 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.
  # 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
    #validateScriptSignature: false # boolean. Optional. Use when ScriptType = FilePath. Validate script signature. Default: false.

Bevitelek

azureConnectionType - Azure-kapcsolat típusa
Bemeneti alias: ConnectedServiceNameSelector. string. Engedélyezett értékek: ConnectedServiceName (Azure Classic), ConnectedServiceNameARM (Azure Resource Manager). Alapértelmezett érték: ConnectedServiceNameARM.

azureClassicSubscription - Klasszikus Azure-előfizetés
Bemeneti alias: ConnectedServiceName. string. Akkor szükséges, ha ConnectedServiceNameSelector = ConnectedServiceName.

A PowerShell futtatása előtt konfigurálni kívánt klasszikus Azure-előfizetés.

azureSubscription - Azure-előfizetés
Bemeneti alias: ConnectedServiceNameARM. string. Akkor szükséges, ha ConnectedServiceNameSelector = ConnectedServiceNameARM.

A PowerShell futtatása előtt konfigurálandó Azure Resource Manager-előfizetés.

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 teljes elérési útnak vagy az alapértelmezett munkakönyvtárhoz képest egynek kell lennie.

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 futtatandó szkriptet spektrálja. A maximális támogatott beágyazott szkripthossz 5000 karakter. Használjon szkriptet egy fájlból, 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. Ezek lehetnek sorszámos vagy elnevezett paraméterek.

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

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

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

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

azurePowerShellVersion - Azure PowerShell verzió
Bemeneti alias: TargetAzurePs. string. Engedélyezett értékek: LatestVersion (Legújabb telepített verzió) OtherVersion (Adjon meg másik verziót). Alapértelmezett érték: OtherVersion.

Üzemeltetett ügynökök esetén a támogatott Azure PowerShell verziók a következők2.1.0: , 3.8.0, 4.2.1és 5.1.16.7.0. 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 (Másik verzió megadása) használatával OtherVersion .

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. Az üzemeltetett ügynökök jelenleg az Azure-modulverziókat 2.1.0, , 3.8.0, 4.2.1és 5.1.1 az AzureRM-modulverziókat 2.1.0, , 3.8.0, 4.2.1, 5.1.1. 6.7.0

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áírt és érvényes-e a végrehajtása előtt.

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

A standard hiba és az ErrorActionPreference 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	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: azureps
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	2.0.0 vagy újabb
Feladatkategória	Üzembe helyezés