Sdílet prostřednictvím


Začínáme s Azure CLI

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

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

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

Až budete připraveni nainstalovat Azure CLI, přečtěte si pokyny k instalaci pro kontejner Windows, Linux, macOS a Docker. Pokud používáte model nasazení Azure Classic, nainstalujte Azure Classic CLI.

Zkontrolujte verzi spuštěním az --versionpříkazu . Azure Cloud Shell má vždy předinstalovanou nejnovější verzi Azure CLI.

az version

Přihlášení 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 az login.

    az login
    

    Pokud azure CLI 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.

    V opačném případě zahájí tok kódu zařízení a dá vám pokyn, abyste otevřeli stránku prohlížeče na https://aka.ms/deviceloginadrese . Pak zadejte kód zobrazený v terminálu.

    Pokud není k dispozici žá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 isDefault: true předplatném jsou aktuálně aktivované předplatné po přihlášení. Pokud chcete vybrat jiné předplatné, použijte příkaz az account set s ID předplatného požadovaného účtu. Další informace o výběru předplatného najdete v tématu Správa 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.

Vyhledání příkazů

Příkazy Azure CLI jsou uspořádané jako skupiny příkazů. Každá skupina představuje oblast služby Azure. Skupiny příkazů můžete najít dvěma způsoby:

  • Použijte příkaz az find. Pokud například chcete vyhledat názvy příkazů obsahující text vm, použijte následující příkaz:

    az find vm
    
  • Pomocí argumentu --help získáte úplný seznam podskupin v rámci referenční skupiny. Tento příklad vrátí všechny podskupiny pro virtuální počítače:

    az vm --help
    

    Tady je příklad výstupu s řádky vynechanými pro stručnost:

    Subgroups:
      application            : Manage applications for VM.
      availability-set       : Group resources into availability sets.
      boot-diagnostics       : Troubleshoot the startup of an Azure Virtual Machine.
      ...
    

    Tady je další příklad, který najde příkazy Azure CLI pro seskupování virtuálních počítačů do skupin dostupnosti, podskupinyaz vm:

    az vm availability-set --help
    

    Slouží --help také k získání seznamů parametrů a příkladů příkazů pro referenční příkaz.

    az vm create --help
    

    Tady je příklad výstupu s řádky vynechanými pro stručnost:

    Arguments
        --name  [Required] : Name of the virtual machine.
        ...
    Authentication Arguments
        --admin-password   : Password for the VM if authentication type is 'Password'.
        --admin-username   : Username for the VM...
        ...
    Managed Service Identity Arguments
        ...
    Examples
        Create a VM from a custom managed image.
          az vm create -g MyResourceGroup -n MyVm --image MyImage
        ...
    
  • Pomocí indexu odkazu A až Z, který obsahuje seznam všech skupin příkazů abecedně.

Vyhledání publikovaných ukázek a článků

Pokud se chcete seznámit se syntaxí Azure CLI pomocí otestovaných publikovaných příkladů, existují dva indexy obsahu článku:

Použití dokončování tabulátoru

Rozhraní příkazového řádku obsahuje úplné dokončování tabulátoru pro příkazy v prostředí Bash. Pokud chcete povolit dokončování tabulátoru v prostředí PowerShell, přečtěte si téma Povolení dokončování tabulátoru v PowerShellu.

Mějte na paměti globálně dostupné argumenty.

Pro většinu příkazů jsou k dispozici některé argumenty.

  • 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átory), table (tabulky ASCII čitelné pro č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. Můžete ho použít například k identifikaci rozhraní REST API, které příkaz spustil, pod ním a odpovědi přijaté ze služby.

  • --subscription je název nebo ID předplatného. Další informace o nastavení výchozího předplatného najdete v tématu Správa předplatných Azure pomocí Azure CLI.

  • --only-show-errors potlačuje upozornění ve výstupu příkazu a zobrazuje pouze chyby.

Použití interaktivního režimu

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 Spuštění Azure CLI v interaktivním režimu.

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ší.

Základní informace o Azure CLI s využitím rychlých zprovoznění a kurzů

Pokud se chcete naučit používat Azure CLI, vyzkoušejte náš kurz onboardingu, který vás naučí následující dovednosti při práci se službou Azure Storage:

Poznámka:

V skriptech a na webu dokumentace Microsoftu jsou příklady Azure CLI napsané pro prostředí Bash. Většina jednořádkových příkladů se bude spouštět na libovolné platformě. Delší příklady, které zahrnují pokračování řádku (\), přiřazení proměnných nebo uvozovky, je potřeba upravit tak, aby fungovaly v jiných prostředích, včetně PowerShellu. Další informace o rozdílech syntaxe mezi prostředími najdete v tématu Rozdíly syntaxe jazyka Bash, PowerShell a Cmd.

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 můžete pomocí integrovaných funkcí rozhraní příkazového řádku zanechat obecnou zpětnou vazbu pomocí příkazu az feedback .

az feedback

Viz také