Začínáme s Azure CLIGet started with Azure CLI

Vítá vás Azure CLI!Welcome to the Azure CLI! Rozhraní příkazového řádku je nástroj navržený tak, aby vám umožnil rychle a efektivně začít pracovat se službami Azure, a to s důrazem na automatizaci.The CLI is a tool designed to get you working quickly and efficiently with Azure services, with an emphasis on automation. Tento článek obsahuje představení funkcí rozhraní příkazového řádku a odkazy na prostředky, které vám pomůžou zvýšit efektivitu.This article introduces features of the CLI and links out to resources that help you be productive.

Poznámka

Ve skriptech a na webu dokumentace Microsoftu jsou příklady Azure CLI napsány pro prostředí bash.In scripts and on the Microsoft documentation site, Azure CLI examples are written for the bash shell. Jednořádkové příklady lze spustit na všech platformách.One-line examples will run on any platform. 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.Longer examples which include line continuations (\) or variable assignment need to be modified to work on other shells, including PowerShell.

Instalace nebo spuštění v Azure Cloud ShelluInstall or run in Azure Cloud Shell

Nejjednodušší způsob, jak začít s rozhraním Azure CLI, je spustit ho v prostředí Azure Cloud Shellu pomocí prohlížeče.The easiest way to get started with the Azure CLI is by running it in an Azure Cloud Shell environment through your browser. Další informace o Cloud Shellu najdete v rychlém zprovoznění pro Bash v Azure Cloud Shellu.To learn about Cloud Shell, see Quickstart for Bash in Azure Cloud Shell.

Až budete připravení nainstalovat si CLI, projděte si pokyny k instalaci.When you're ready to install the CLI, see the installation instructions.

Po prvním instalaci rozhraní příkazového řádku ověřte, že je nainstalovaný a že máte správnou verzi, spuštěním az --version.After installing the CLI for the first time, check that it's installed and you've got the correct version by running az --version.

PřihlášeníSign in

Před použitím jakýchkoli příkazů rozhraní příkazového řádku v místní instalaci se musíte přihlásit pomocí příkazu az login.Before using any CLI commands with a local install, you need to sign in with az login.

  1. Spusťte příkaz login.Run the login command.

    az login
    

    Pokud rozhraní příkazového řádku může spustit výchozí prohlížeč, udělá to a načte přihlašovací stránku.If the CLI can open your default browser, it will do so and load a sign-in page.

    V opačném případě musíte otevřít stránku prohlížeče a postupovat podle pokynů v příkazovém řádku. Po přechodu na https://aka.ms/devicelogin v prohlížeči zadejte autorizační kód.Otherwise, you need to open a browser page and follow the instructions on the command line to enter an authorization code after navigating to https://aka.ms/devicelogin in your browser.

  2. Přihlaste se pomocí přihlašovacích údajů vašeho účtu v prohlížeči.Sign in with your account credentials in the browser.

Po přihlášení se zobrazí seznam předplatných přidružených k vašemu účtu Azure.After logging in, you see a list of subscriptions associated with your Azure account. Informace o předplatném s isDefault: true je aktuálně aktivované předplatné po přihlášení.The subscription information with isDefault: true is the currently activated subscription after logging in. Pokud chcete vybrat jiné předplatné, přejděte k přepínači pomocí příkazu AZ Account set s ID předplatného.To select another subscription, use the az account set command with the subscription ID to switch to. Další informace o výběru předplatného najdete v tématu použití více předplatných Azure.For more information about subscription selection, see Use multiple Azure subscriptions.

Existují i způsoby, jak se přihlásit neinteraktivně. Ty jsou podrobně popsané v tématu Přihlášení pomocí Azure CLI.There are ways to sign in non-interactively, which are covered in detail in Sign in with Azure CLI.

Běžné příkazyCommon commands

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.This table lists some common commands used in the CLI and links to their reference documentation.

Typ prostředkuResource type Skupina příkazů Azure CLIAzure CLI command group
Skupina prostředkůResource group az groupaz group
Virtual MachinesVirtual machines az vmaz vm
Účty úložištěStorage accounts az storage accountaz storage account
Key VaultKey Vault az keyvaultaz keyvault
Webové aplikaceWeb applications az webappaz webapp
Databáze SQLSQL databases az sql serveraz sql server
Cosmos DBCosmosDB az cosmosdbaz cosmosdb

Hledání příkazůFinding commands

Příkazy v rozhraní příkazového řádku jsou uspořádané jako příkazy v rámci skupin.Commands in the CLI are organized as commands of groups. Každá skupina představuje jednu službu Azure a příkazy se používají právě pro ni.Each group represents an Azure service, and commands operate on that service.

K vyhledávání příkazů použijte příkaz az find.To search for commands, use az find. Pokud například chcete vyhledat názvy příkazů obsahující text secret, použijte následující příkaz:For example, to search for command names containing secret, use the following command:

az find secret

K získání kompletního seznamu příkazů a podskupin skupiny použijte argument --help.Use the --help argument to get a complete list of commands and subgroups of a group. Pokud například chcete najít příkazy CLI pro práci se skupinami zabezpečení sítě (NSG):For example, to find the CLI commands for working with Network Security Groups (NSGs):

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.The CLI has full tab completion for commands under the bash shell.

Globálně dostupné argumentyGlobally available arguments

Existuje několik argumentů, které jsou dostupné pro všechny příkazy.There are some arguments that are available for every command.

  • 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.--help prints CLI reference information about commands and their arguments and lists available subgroups and commands.
  • Argument --output změní formát výstupu.--output changes the output format. Dostupné výstupní jsonformáty jsou (s jsonc barevným kódem JSON), tsv (hodnoty oddělené tabulátory) table , (uživatelsky čitelné tabulky ASCII) a yaml.The available output formats are json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables), and yaml. Ve výchozím nastavení je výstup rozhraní příkazového řádku ve formátu json.By default the CLI outputs json. Další informace o dostupných formátech výstupu najdete v tématu Formáty výstupu pro Azure CLI.To learn more about the available output formats, see Output formats for Azure CLI.
  • Argument --query s využitím dotazovacího jazyka JMESPath filtruje výstup vrácený ze služeb Azure.--query uses the JMESPath query language to filter the output returned from Azure services. Další informace o dotazech najdete v tématu dotazování výsledků příkazů pomocí Azure CLI a kurzu JMESPath.To learn more about queries, see Query command results with Azure CLI and the JMESPath tutorial.
  • 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.--verbose prints information about resources created in Azure during an operation, and other useful information.
  • 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í.--debug prints even more information about CLI operations, used for debugging purposes. Pokud narazíte na chybu, při odesílání zprávy o chybě zadejte výstup vygenerovaný pomocí příznaku --debug.If you find a bug, provide output generated with the --debug flag on when submitting a bug report.

Interaktivní režimInteractive mode

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ů.The CLI offers an interactive mode that automatically displays help information and makes it easier to select subcommands. Do interaktivního režimu přejdete pomocí příkazu az interactive.You enter interactive mode with the az interactive command.

az interactive

Další informace o interaktivním režimu najdete v tématu Interaktivní režim Azure CLI.For more information on interactive mode, see Azure CLI Interactive Mode.

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ší.There's also a Visual Studio Code plugin that offers an interactive experience, including autocomplete and mouse-over documentation.

Seznámení se základy rozhraní příkazového řádku s využitím rychlých startů a kurzůLearn CLI basics with quickstarts and tutorials

Pokud chcete začít s Azure CLI, vyzkoušejte podrobný kurz nastavení virtuálních počítačů a využití výkonu rozhraní příkazového řádku k dotazování prostředků Azure.To get you started with the Azure CLI, try an in-depth tutorial for setting up virtual machines and using the power of the CLI to query Azure resources.

K dispozici jsou také rychlé starty pro další oblíbené služby.There are also quickstarts for other popular services.

Váš názorGive feedback

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.We welcome your feedback for the CLI to help us make improvements and resolve bugs. Můžete zaslat problém na GitHubu nebo použít integrované funkce rozhraní příkazového řádku, abyste ponechali obecnou zpětnou vazbu pomocí příkazu AZ Feedback .You can file an issue on GitHub or use the built-in features of the CLI to leave general feedback with the az feedback command.

az feedback