Rozpoczynanie pracy z interfejsem wiersza polecenia platformy AzureGet started with Azure CLI

Interfejs wiersza polecenia platformy Azure — Zapraszamy!Welcome to the Azure CLI! Interfejs wiersza polecenia to narzędzie umożliwiające szybką i skuteczną pracę z usługami platformy Azure, ze szczególnym uwzględnieniem automatyzacji.The CLI is a tool designed to get you working quickly and efficiently with Azure services, with an emphasis on automation. W tym artykule przedstawiono funkcje interfejsu wiersza polecenia i linki do zasobów, które pomagają poprawić wydajność pracy.This article introduces features of the CLI and links out to resources that help you be productive.

Instalowanie lub uruchamianie w usłudze Azure Cloud ShellInstall or run in Azure Cloud Shell

Najprostszym sposobem, aby rozpocząć pracę z interfejsem wiersza polecenia platformy Azure, jest uruchomienie go w środowisku usługi Azure Cloud Shell za pośrednictwem przeglądarki.The easiest way to get started with the Azure CLI is by running it in an Azure Cloud Shell environment through your browser. Aby dowiedzieć się więcej o usłudze Cloud Shell, zobacz Przewodnik Szybki start dotyczący powłoki Bash w usłudze Azure Cloud Shell.To learn about Cloud Shell, see Quickstart for Bash in Azure Cloud Shell.

Gdy wszystko będzie gotowe do zainstalowania interfejsu wiersza polecenia, zobacz instrukcje dotyczące instalacji.When you're ready to install the CLI, see the installation instructions.

LogowanieSign in

Aby korzystać z poleceń interfejsu wiersza polecenia w ramach instalacji lokalnej, musisz zalogować się przy użyciu polecenia az login.Before using any CLI commands with a local install, you need to sign in with az login.

  1. Uruchom polecenie login.Run the login command.

    az login
    

    Jeśli interfejs wiersza polecenia może otworzyć Twoją domyślną przeglądarkę, zrobi to i załaduje stronę logowania.If the CLI can open your default browser, it will do so and load a sign-in page.

    W przeciwnym razie otwórz stronę przeglądarki i wykonaj instrukcje podane w wierszu polecenia, aby wprowadzić kod autoryzacji po przejściu do strony https://aka.ms/devicelogin w przeglądarce.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. Zaloguj się w przeglądarce przy użyciu poświadczeń swojego konta.Sign in with your account credentials in the browser.

Istnieją sposoby logowania nieinterakcyjnego, które opisano szczegółowo w artykule Logowanie się za pomocą interfejsu wiersza polecenia platformy Azure.There are ways to sign in non-interactively, which are covered in detail in Sign in with Azure CLI.

Typowe poleceniaCommon commands

W tej tabeli znajdują się niektóre typowe polecenia używane w interfejsie wiersza polecenia i linki do ich dokumentacji.This table lists some common commands used in the CLI and links to their reference documentation.

Typ zasobuResource type Grupa poleceń interfejsu wiersza polecenia platformy AzureAzure CLI command group
Grupa zasobówResource group az groupaz group
Maszyny wirtualneVirtual machines az vmaz vm
Konta magazynuStorage accounts az storage accountaz storage account
Usługa Key VaultKey Vault az keyvaultaz keyvault
Aplikacje internetoweWeb applications az webappaz webapp
Bazy danych SQLSQL databases az sql serveraz sql server
CosmosDBCosmosDB az cosmosdbaz cosmosdb

Znajdowanie poleceńFinding commands

Polecenia w interfejsie wiersza polecenia są zorganizowane jako polecenia grup.Commands in the CLI are organized as commands of groups. Każda grupa reprezentuje usługę platformy Azure, a polecenia działają w tej usłudze.Each group represents an Azure service, and commands operate on that service.

Aby wyszukać polecenia, użyj polecenia az find.To search for commands, use az find. Na przykład aby wyszukać nazwy polecenia zawierające secret, użyj następującego polecenia:For example, to search for command names containing secret, use the following command:

az find -q secret

Aby uzyskać pełną listę poleceń i podgrup grupy, użyj argumentu --help.Use the --help argument to get a complete list of commands and subgroups of a group. Na przykład aby znaleźć polecenia interfejsu wiersza polecenia do pracy z sieciowymi grupami zabezpieczeń (NSG):For example, to find the CLI commands for working with Network Security Groups (NSGs):

az network nsg --help

Interfejs wiersza polecenia obsługuje pełne wypełnianie po naciśnięciu klawisza TAB dla poleceń w obszarze powłoki bash.The CLI has full tab completion for commands under the bash shell.

Globalnie dostępne argumentyGlobally available arguments

Istnieją pewne argumenty, które są dostępne dla każdego polecenia.There are some arguments that are available for every command.

  • Argument --help wyświetla informacje referencyjne interfejsu wiersza polecenia o poleceniach oraz ich argumentach i wyświetla dostępne podgrupy i polecenia.--help prints CLI reference information about commands and their arguments and lists available subgroups and commands.
  • Argument --output zmienia format danych wyjściowych.--output changes the output format. Dostępne formaty danych wyjściowych: json, jsonc (pokolorowany ciąg JSON), tsv (wartości rozdzielane znakami tabulacji) i table (czytelne dla człowieka tabele ASCII).The available output formats are json, jsonc (colorized JSON), tsv (Tab-Separated Values), and table (human-readable ASCII tables). Domyślnie interfejs wiersza polecenia zwraca format json.By default the CLI outputs json. Aby dowiedzieć się więcej na temat dostępnych formatów danych wyjściowych, zobacz Formaty danych wyjściowych dla interfejsu wiersza polecenia platformy Azure.To learn more about the available output formats, see Output formats for Azure CLI.
  • Argument --query używa języka zapytań JMESPath, aby filtrować dane wyjściowe zwrócone z usług platformy Azure.--query uses the JMESPath query language to filter the output returned from Azure services. Aby dowiedzieć się więcej o zapytaniach, zobacz Wykonywanie zapytań względem wyników poleceń za pomocą interfejsu wiersza polecenia platformy Azure i Samouczek dotyczący zapytań JMESPath.To learn To learn more about queries, see Query command results with Azure CLI and the JMESPath tutorial.
  • Argument --verbose wyświetla informacje o zasobach utworzonych na platformie Azure podczas operacji oraz inne przydatne informacje.--verbose prints information about resources created in Azure during an operation, and other useful information.
  • Argument --debug drukuje nawet więcej informacji o operacjach interfejsu wiersza polecenia, używanych na potrzeby debugowania.--debug prints even more information about CLI operations, used for debugging purposes. Jeśli znajdziesz usterkę, podaj dane wyjściowe wygenerowane z flagą --debug podczas przesyłania raportu o usterce.If you find a bug, provide output generated with the --debug flag on when submitting a bug report.

Tryb interaktywnyInteractive mode

Interfejs wiersza polecenia oferuje tryb interaktywny, który automatycznie wyświetla informacje pomocy i ułatwia wybór podpoleceń.The CLI offers an interactive mode that automatically displays help information and makes it easier to select subcommands. W tryb interaktywny wchodzi się za pomocą polecenia az interactive.You enter interactive mode with the az interactive command.

az interactive

Aby uzyskać więcej informacji o trybie interaktywnym, zobacz Tryb interaktywny interfejsu wiersza polecenia platformy Azure.For more information on interactive mode, see Azure CLI Interactive Mode.

Istnieje również wtyczka programu Visual Studio Code, która oferuje środowisko interaktywne, w tym autouzupełnianie i dokumentację aktywowaną kursorem myszy.There's also a Visual Studio Code plugin that offers an interactive experience, including autocomplete and mouse-over documentation.

Nauka podstaw interfejsu wiersza polecenia za pomocą samouczków i przewodników Szybki StartLearn CLI basics with quickstarts and tutorials

Aby rozpocząć pracę z interfejsem wiersza polecenia platformy Azure, wypróbuj szczegółowy samouczek dotyczący konfigurowania maszyn wirtualnych i używania interfejsu wiersza polecenia do wykonywania zapytań względem zasobów platformy 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.

Dostępne są także przewodniki Szybki start dotyczące innych popularnych usług.There are also quickstarts for other popular services.

Przesyłanie opiniiGive feedback

Chętnie poznamy Twoją opinię dotyczącą interfejsu wiersza polecenia, która pomoże nam wprowadzić ulepszenia i usunąć błędy.We welcome your feedback for the CLI to help us make improvements and resolve bugs. Możesz zgłosić problem w usłudze Github lub skorzystać z wbudowanych funkcji interfejsu wiersza polecenia, aby przesłać ogólną opinię za pomocą polecenia 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