AzureCLI@1 – Azure CLI v1-feladat

Futtassa az Azure CLI-parancsokat egy Azure-előfizetésen egy rendszerhéjszkriptben, amikor Linux-ügynökön vagy kötegelt szkripten fut a Windows-ügynökön való futtatáskor.

Syntax

# Azure CLI v1
# Run Azure CLI commands against an Azure subscription in a Shell script when running on Linux agent or Batch script when running on Windows agent.
- task: AzureCLI@1
  inputs:
    azureSubscription: # string. Alias: connectedServiceNameARM. Required. Azure subscription. 
    scriptLocation: 'scriptPath' # 'inlineScript' | 'scriptPath'. Required. Script Location. Default: scriptPath.
    scriptPath: # string. Required when scriptLocation = scriptPath. Script Path. 
    #inlineScript: # string. Required when scriptLocation = inlineScript. Inline Script. 
    #arguments: # string. Alias: args. Arguments. 
  # Advanced
    #addSpnToEnvironment: false # boolean. Access service principal details in script. Default: false.
    #useGlobalConfig: false # boolean. Use global Azure CLI configuration. Default: false.
    #workingDirectory: # string. Alias: cwd. Working Directory. 
    #failOnStandardError: false # boolean. Fail on Standard Error. Default: false.

Bevitelek

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

Kiválaszt egy Azure Resource Manager-előfizetést az üzembe helyezéshez.

scriptLocation - Szkript helye
string. Kötelező. Engedélyezett értékek: inlineScript (beágyazott szkript), scriptPath (Szkript elérési útja). Alapértelmezett érték: scriptPath.

Kiválasztja a szkript helyét.

scriptPath - Szkript elérési útja
string. Akkor szükséges, ha scriptLocation = scriptPath.

A szkript teljes elérési útja vagy az alapértelmezett munkakönyvtárhoz viszonyított elérési út.

inlineScript - Beágyazott szkript
string. Akkor szükséges, ha scriptLocation = inlineScript.

A szkripteket ide írhatja. Windows-ügynök használata esetén használjon kötegelt szkriptelést. Linux-alapú ügynökök használatakor használjon rendszerhéjszkriptet. Kötegelt fájlok esetén használja az előtagot call minden Azure-parancs előtt. Előre definiált és egyéni változókat is átadhat ehhez a szkripthez argumentumok használatával

Lásd az alábbi példákat. Az első egy felületi példa, a második pedig egy kötegelt példa:

azure --version || azure account show 

call  azure --version || call azure account show

arguments - Érvek
Bemeneti alias: args. string.

A szkriptnek átadott argumentumok.

addSpnToEnvironment - A szolgáltatásnév részleteinek elérése a szkriptben
boolean. Alapértelmezett érték: false.

Hozzáadja a parancsprogram végrehajtási környezetéhez kiválasztott Azure-végpont egyszerű szolgáltatásazonosítóját és kulcsát. A és $servicePrincipalKey változókat $servicePrincipalId használhatja a szkriptben.

Ez csak akkor történik meg, ha az Azure-végpont szolgáltatásnév hitelesítési sémával rendelkezik.

useGlobalConfig - Globális Azure CLI-konfiguráció használata
boolean. Alapértelmezett érték: false.

Ha ez hamis, ez a feladat a saját különálló Azure CLI-konfigurációs könyvtárát fogja használni. Ez az Azure CLI-feladatok párhuzamos kiadásokban való futtatására használható.

workingDirectory - Munkakönyvtár
Bemeneti alias: cwd. string.

Aktuális munkakönyvtár, ahol a szkript fut. Ha üresen marad, ez a bemenet az adattár (build) vagy az összetevők (kiadás) gyökere, amely a következő $(System.DefaultWorkingDirectory): .

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

Ha ez a bemenet igaz, ez a feladat sikertelen lesz, ha bármilyen hibát ír a StandardError streambe. Törölje a jelölőnégyzet jelölését, hogy figyelmen kívül hagyja a szokásos hibákat, és ehelyett a kilépési kódokra támaszkodva állapítsa meg az állapotot.

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 1.0-s verzió újdonságai:

• Támogatja az új Azure CLI 2.0-t, amely Python-alapú
• Platformfüggetlen ügynökökkel (Linux, macOS vagy Windows) működik
• Az Azure CLI 1.0 (node.js-alapú) használatához váltson a 0.0-s feladatverzióra
• Korlátozások: – A klasszikus Azure-előfizetések nem támogatottak. Az Azure CLI 2.0 csak az Azure Resource Manager -előfizetéseket támogatja.

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