AzureCLI@1 – úloha Azure CLI v1

Při spuštění v agentu Linuxu nebo dávkovém skriptu při spuštění v agentu s Windows spusťte příkazy Azure CLI pro předplatné Azure ve skriptu prostředí.

Syntaxe

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

Vstupy

azureSubscription - předplatného Azure
Vstupní alias: connectedServiceNameARM. string. Povinné.

Vybere předplatné Azure Resource Manageru pro nasazení.

umístění skriptu scriptLocation -
string. Povinné. Povolené hodnoty: inlineScript (vložený skript), scriptPath (cesta ke skriptu). Výchozí hodnota: scriptPath.

Vybere umístění skriptu.

cesta ke skriptu scriptPath -
string. Požadováno při scriptLocation = scriptPath.

Plně kvalifikovaná cesta skriptu nebo cesty vzhledem k výchozímu pracovnímu adresáři.

inlineScript - vložený skript
string. Požadováno při scriptLocation = inlineScript.

Skripty můžete napsat přímo tady. Při použití agenta pro Windows použijte dávkové skriptování. Skriptování prostředí použijte při použití agentů založených na Linuxu. Pro dávkové soubory použijte před každým příkazem Azure předponu call. Do tohoto skriptu můžete také předat předdefinované a vlastní proměnné pomocí argumentů.

Podívejte se na následující příklady. První je příklad prostředí a druhý je ukázkovým příkladem dávky:

azure --version || azure account show 

call  azure --version || call azure account show

argumentů
Vstupní alias: args. string.

Argumenty předané skriptu.

addSpnToEnvironment - podrobností o instančním objektu accessu ve skriptu
boolean. Výchozí hodnota: false.

Přidá ID instančního objektu a klíč koncového bodu Azure, který jste zvolili do spouštěcího prostředí skriptu. Ve skriptu můžete použít proměnné $servicePrincipalId a $servicePrincipalKey.

Toto se respektuje jenom v případě, že koncový bod Azure má schéma ověřování instančního objektu.

useGlobalConfig - použití globální konfigurace Azure CLI
boolean. Výchozí hodnota: false.

Pokud je tato hodnota false, použije tato úloha vlastní samostatný konfigurační adresář Azure CLI. Dá se použít ke spouštění úloh Azure CLI v paralelních verzích.

workingDirectory - pracovní adresář
Vstupní alias: cwd. string.

Aktuální pracovní adresář, ve kterém se skript spouští. Pokud je toto pole prázdné, je tento vstup kořenem úložiště (sestavení) nebo artefaktů (verze), což je $(System.DefaultWorkingDirectory).

Selhání failOnStandardError - na standardním chyb
boolean. Výchozí hodnota: false.

Pokud je tento vstup pravdivý, tato úloha selže při zápisu chyb do streamu StandardError. Zrušte zaškrtnutí políčka, pokud chcete ignorovat standardní chyby, a místo toho se při určování stavu spoléhají na ukončovací kódy.

Možnosti ovládání úloh

Všechny úlohy mají kromě vstupů také možnosti ovládání. Další informace naleznete v tématu Možnosti ovládacího prvku a běžné vlastnosti úloh.

Výstupní proměnné

Žádné.

Poznámky

Novinky ve verzi 1.0:

• Podporuje nové Rozhraní příkazového řádku Azure CLI 2.0, které je založené na Pythonu.
• Funguje s agenty pro různé platformy (Linux, macOS nebo Windows)
• Pro práci s Azure CLI 1.0 (na základěnode.js) přejděte na úlohu verze 0.0.
• Omezení: Žádná podpora pro předplatná Azure Classic. Azure CLI 2.0 podporuje jenom předplatná Azure Resource Manageru (ARM).

Požadavky

Požadavek	Popis
Typy kanálů	YAML, klasické sestavení, klasická verze
Běží na	Agent, DeploymentGroup
požadavky	Žádný
možnosti	Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
omezení příkazů	Jakýkoliv
nastavitelné proměnné	Jakýkoliv
Verze agenta	2.0.0 nebo vyšší
Kategorie úkolu	Nasadit