Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Rozhraní Azure Command-Line (CLI) je multiplatformní nástroj příkazového řádku pro připojení k Azure a spouštění příkazů pro správu na Azure prostředcích. Umožňuje spouštět příkazy prostřednictvím terminálu pomocí interaktivního příkazového řádku nebo prostřednictvím skriptu.
Pro interaktivní použití nejprve spustíte prostředí, jako je cmd.exe na Windows nebo Bash v Linuxu nebo macOS, a pak vydáte příkaz na příkazovém řádku prostředí. Pokud chcete automatizovat opakující se úlohy, sestavíte příkazy rozhraní příkazového řádku do skriptu prostředí pomocí syntaxe skriptu zvoleného prostředí a pak skript spustíte.
Můžete nainstalovat Azure CLI místně na počítačích s Linuxem, macOS nebo Windows. Můžete ho také použít z prohlížeče prostřednictvím Azure Cloud Shell nebo spustit z kontejneru Dockeru.
Aktuální verze
Aktuální verze Azure CLI je 2.85.0. Informace o nejnovější verzi najdete v poznámkách k verzi . Pokud chcete najít nainstalovanou verzi a zjistit, jestli potřebujete aktualizovat, spusťte příkaz az version.
Autentizace
Azure CLI podporuje několik metod ověřování. Podrobné informace o ověřování v Azure z Azure CLI najdete v tématu Sign in with Azure CLI.
Návrh referenčního příkazu
Syntaxe Azure CLI se řídí jednoduchým vzorem reference name - command - parameter - parameter value. Například přepínání mezi předplatnými je často běžnou úlohou. Tady je syntaxe.
az account set --subscription "my subscription name"
Dalším běžným použitím Azure CLI je správa přiřazení rolí.
az role assignment create --assignee servicePrincipalName --role Reader --scope /subscriptions/mySubscriptionID/resourceGroups/myResourceGroupName
az role assignment delete --assignee userSign-inName --role Contributor
Další informace o správě předplatných najdete v tématu Spravování předplatných s Azure CLI. Podrobný kurz správy instančních objektů a přiřazení rolí najdete v tématu Vytvoření instančního objektu Azure pomocí Azure CLI.
Porovnání syntaxe PowerShellu
Choose the right command-line tool vysvětluje rozdíl mezi tools a environments s důrazem na Azure CLI a Azure PowerShell. Nabízí také řadu porovnání příkazů vedle sebe. Zde jsou dva příklady:
| Příkaz | Azure CLI | Azure PowerShell |
|---|---|---|
| Vytvořte skupinu prostředků | az group create --name <ResourceGroupName> --location eastus // Tento příkaz vytvoří skupinu prostředků ve vybrané oblasti eastus. | <New-AzResourceGroup -Name ResourceGroupName> -Location eastus |
| Vytvoření účtu Azure Storage | az storage account create --name <StorageAccountName> --resource-group <ResourceGroupName> --location eastus --sku Standard_LRS --kind StorageV2 # Vytvořit účet úložiště s daným názvem, ve specifikované skupině zdrojů, v lokaci eastus, s modelem Standard_LRS a typem StorageV2 | <New-AzStorageAccount -Name StorageAccountName> -ResourceGroupName <ResourceGroupName> -Location eastus -SkuName Standard_LRS -Kind StorageV2 |
Porovnání syntaxe Azure CLI mezi prostředími Bash a PowerShellem najdete v tématu Azure CLI> Rozdíly v syntaxi Bash, PowerShellu a Cmd.
Formáty výstupu
Azure CLI jako výchozí výstupní formát používá JSON, ale nabízí jiné formáty, jak je popsáno v FormátyOutput pro příkazy Azure CLI. K formátování výsledků příkazů Azure CLI použijte parametr --output. Tady je příklad:
az account list --output table
Nastavte výchozí výstup nastavením vlastnosti konfigurace output, jak je popsáno v konfiguraci Azure CLI.
az config set core.output=jsonc
Příprava dat
Azure CLI ve výchozím nastavení shromažďuje telemetrická data. Microsoft agreguje shromážděná data za účelem identifikace vzorů použití k identifikaci běžných problémů a ke zlepšení zkušeností Azure CLI. Microsoft Azure CLI neshromažďuje žádné soukromé ani osobní údaje. Například data o využití pomáhají identifikovat problémy, jako jsou příkazy s nízkým úspěchem, a pomáhají určit prioritu naší práce.
Přestože oceňujeme přehledy, které tato data poskytují, chápeme také, že ne každý chce údaje o využití odesílat. Shromažďování dat můžete pomocí az config set core.collect_telemetry=false příkazu zakázat. Můžete si také přečíst naše prohlášení o zásadách ochrany osobních údajů, kde se dozvíte víc.