Začínáme s Azure CLI

  • Článek

Vítejte v rozhraní Azure Command-Line (CLI)! Tento článek představuje rozhraní příkazového řádku a pomáhá provádět běžné úlohy.

Poznámka

Ve skriptech a na webu dokumentace Microsoftu jsou příklady Azure CLI napsány pro prostředí bash. Jednořádkové příklady lze spustit na všech platformách. Delší příklady zahrnující pokračování řádku (\) nebo přiřazení proměnných je potřeba upravit, aby fungovaly v jiných prostředích, včetně PowerShellu.

Instalace nebo spuštění v Azure Cloud Shellu

Nejjednodušší způsob, jak používat Azure CLI, je jeho spuštěním v prostředí Azure Cloud Shell v prohlížeči. Další informace o Cloud Shellu najdete v tématu Rychlý start pro Bash v Azure Cloud Shellu.

Až budete připravení nainstalovat si CLI, projděte si pokyny k instalaci.

Po první instalaci rozhraní příkazového řádku zkontrolujte, jestli je nainstalovaná a že máte správnou verzi spuštěním az --version.

Poznámka

Pokud používáte model nasazení Azure Classic, nainstalujte Azure Classic CLI.

Jak se přihlásit k Azure CLI

Před použitím příkazů Azure CLI s místní instalací se musíte přihlásit pomocí příkazu az login.

  1. Spusťte příkaz login.

    az login

    Pokud rozhraní příkazového řádku může otevřít váš výchozí prohlížeč, zahájí tok autorizačního kódu a otevře výchozí prohlížeč pro načtení přihlašovací stránky Azure.

    Jinak zahájí tok kódu zařízení a řekne vám, že otevřete stránku https://aka.ms/devicelogin prohlížeče a zadáte kód zobrazený v terminálu.

    Pokud není dostupný žádný webový prohlížeč nebo se webový prohlížeč neotevře, můžete vynutit tok kódu zařízení pomocí příkazu az login --use-device-code.

  2. Přihlaste se pomocí přihlašovacích údajů vašeho účtu v prohlížeči.

Po přihlášení se zobrazí seznam předplatných přidružených k vašemu účtu Azure. Informace o předplatném isDefault: true jsou aktuálně aktivované předplatné po přihlášení. Pokud chcete vybrat jiné předplatné, pomocí příkazu az account set s ID předplatného přepněte na. Další informace o výběru předplatného najdete v tématu Použití více předplatných Azure.

Existují i způsoby, jak se přihlásit neinteraktivně. Ty jsou podrobně popsané v tématu Přihlášení pomocí Azure CLI.

Příkazy rozhraní příkazového řádku Azure

Tato tabulka obsahuje některé běžné příkazy používané v rozhraní příkazového řádku a odkazy na příslušnou referenční dokumentaci.

Typ prostředku Skupina příkazů Azure CLI
Skupina prostředků az group
Virtual Machines az vm
Účty úložiště az storage account
Key Vault az keyvault
Webové aplikace az webapp
Databáze SQL az sql server
CosmosDB az cosmosdb

Hledání příkazů

Příkazy Azure CLI jsou uspořádané jako příkazyskupin. Každá skupina představuje jednu službu Azure a příkazy se používají právě pro ni.

K vyhledávání příkazů použijte příkaz az find. Pokud například chcete vyhledat názvy příkazů obsahující text secret, použijte následující příkaz:

az find secret

K získání kompletního seznamu příkazů a podskupin skupiny použijte argument --help. Pokud například chcete najít příkazy CLI pro práci se skupinami zabezpečení sítě (NSG):

az network nsg --help

Rozhraní příkazového řádku poskytuje úplné dokončování pomocí tabulátorů pro příkazy v rámci prostředí Bash.

Globálně dostupné argumenty

Existuje několik argumentů, které jsou dostupné pro všechny příkazy.

  • Argument --help vypíše referenční informace rozhraní příkazového řádku o příkazech a jejich argumentech a také dostupné podskupiny a příkazy.
  • Argument --output změní formát výstupu. Dostupné výstupní formáty jsou json, jsonc (barevné JSON), tsv (hodnoty oddělené tabulátorem), table (tabulky ASCII pro čtení člověka) a yaml. Ve výchozím nastavení je výstup rozhraní příkazového řádku ve formátu json. Další informace o dostupných formátech výstupu najdete v tématu Formáty výstupu pro Azure CLI.
  • Argument --query s využitím dotazovacího jazyka JMESPath filtruje výstup vrácený ze služeb Azure. Další informace o dotazech najdete v tématu Výsledky příkazů dotazu pomocí Azure CLI a kurzu JMESPath.
  • Argument --verbose vypíše informace o prostředcích vytvořených v Azure během určité operace a další užitečné informace.
  • Argument --debug vypíše ještě podrobnější informace o operacích rozhraní příkazového řádku, které se používají pro účely ladění. Pokud narazíte na chybu, při odesílání zprávy o chybě zadejte výstup vygenerovaný pomocí příznaku --debug.

Interaktivní režim

Rozhraní příkazového řádku nabízí interaktivní režim, který automaticky zobrazuje informace nápovědy a usnadňuje výběr dílčích příkazů. Do interaktivního režimu přejdete pomocí příkazu az interactive.

az interactive

Další informace o interaktivním režimu najdete v tématu Interaktivní režim Azure CLI.

Existuje také modul plug-in pro Visual Studio Code, který nabízí interaktivní prostředí, včetně automatického dokončování a zobrazení dokumentace po najetí myší.

Seznámení se základy rozhraní příkazového řádku s využitím rychlých startů a kurzů

Pokud se chcete dozvědět, jak používat Azure CLI, vyzkoušejte podrobný kurz pro nastavení virtuálních počítačů a použití výkonu rozhraní příkazového řádku k dotazování prostředků Azure.

Kurz vytváření virtuálních počítačů pomocí Azure CLI

K dispozici jsou také rychlé starty pro další oblíbené služby.

Poskytnout zpětnou vazbu

Vítáme váš názor na rozhraní příkazového řádku, který nám pomáhá provádět vylepšení a řešit chyby. Problém můžete podat na GitHubu nebo pomocí integrovaných funkcí rozhraní příkazového řádku nechat obecnou zpětnou vazbu pomocí příkazu az feedback .

az feedback

Viz také