Rozpoczynanie pracy z interfejsem wiersza polecenia platformy Azure

Witamy w interfejsie azure Command-Line (CLI)! W tym artykule przedstawiono interfejs wiersza polecenia i ułatwia wykonywanie typowych zadań.

Uwaga

W skryptach i w witrynie dokumentacji firmy Microsoft przykłady dla interfejsu wiersza polecenia platformy Azure są napisane dla powłoki bash. Jednowierszowe przykłady będą działać na każdej platformie. Dłuższe przykłady, obejmujące kontynuacje wierszy (\) lub przypisywanie zmiennej, muszą zostać zmodyfikowane, aby pracowały w innych powłokach, w tym w programie PowerShell.

Instalowanie lub uruchamianie w usłudze Azure Cloud Shell

Najprostszym sposobem, aby dowiedzieć się, jak używać interfejsu wiersza polecenia platformy Azure, jest uruchomienie go w środowisku usługi Azure Cloud Shell za pośrednictwem przeglądarki. 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.

Gdy wszystko będzie gotowe do zainstalowania interfejsu wiersza polecenia, zobacz instrukcje dotyczące instalacji.

Po zainstalowaniu interfejsu wiersza polecenia po raz pierwszy sprawdź, czy jest on zainstalowany i masz poprawną wersję, uruchamiając polecenie az --version.

Uwaga

Jeśli używasz klasycznego modelu wdrażania platformy Azure, zainstaluj klasyczny interfejs wiersza polecenia platformy Azure.

Jak zalogować się do interfejsu wiersza polecenia platformy Azure

Przed użyciem jakichkolwiek poleceń interfejsu wiersza polecenia platformy Azure z instalacją lokalną należy zalogować się za pomocą polecenia az login.

  1. Uruchom polecenie login.

    az login
    

    Jeśli interfejs wiersza polecenia może otworzyć domyślną przeglądarkę, zainicjuje przepływ kodu autoryzacji i otworzy domyślną przeglądarkę, aby załadować stronę logowania platformy Azure.

    W przeciwnym razie zainicjuje przepływ kodu urządzenia i informuje o otwarciu strony przeglądarki pod adresem https://aka.ms/devicelogin i wprowadzeniu kodu wyświetlanego w terminalu.

    Jeśli przeglądarka internetowa nie jest dostępna lub przeglądarka internetowa nie zostanie otwarta, możesz wymusić przepływ kodu urządzenia za pomocą polecenia az login --use-device-code.

  2. Zaloguj się w przeglądarce przy użyciu poświadczeń swojego konta.

Po zalogowaniu zostanie wyświetlona lista subskrypcji skojarzonych z kontem platformy Azure. Informacje o subskrypcji z programem isDefault: true to aktualnie aktywowana subskrypcja po zalogowaniu. Aby wybrać inną subskrypcję, użyj polecenia az account set z identyfikatorem subskrypcji, aby przełączyć się na. Aby uzyskać więcej informacji na temat wyboru subskrypcji, zobacz Korzystanie z wielu subskrypcji platformy Azure.

Istnieją sposoby logowania nieinterakcyjnego, które opisano szczegółowo w artykule Logowanie się za pomocą interfejsu wiersza polecenia platformy Azure.

Typowe polecenia interfejsu wiersza polecenia platformy Azure

W tej tabeli znajdują się niektóre typowe polecenia używane w interfejsie wiersza polecenia i linki do ich dokumentacji.

Typ zasobu Grupa poleceń interfejsu wiersza polecenia platformy Azure
Grupa zasobów az group
Maszyny wirtualne az vm
Konta magazynu az storage account
Usługa Key Vault az keyvault
Aplikacje internetowe az webapp
Bazy danych SQL az sql server
CosmosDB az cosmosdb

Znajdowanie poleceń

Polecenia interfejsu wiersza polecenia platformy Azure są zorganizowane jako poleceniagrup. Każda grupa reprezentuje usługę platformy Azure, a polecenia działają w tej usłudze.

Aby wyszukać polecenia, użyj polecenia az find. Na przykład aby wyszukać nazwy polecenia zawierające secret, użyj następującego polecenia:

az find secret

Aby uzyskać pełną listę poleceń i podgrup grupy, użyj argumentu --help. Na przykład aby znaleźć polecenia interfejsu wiersza polecenia do pracy z sieciowymi grupami zabezpieczeń (NSG):

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.

Globalnie dostępne argumenty

Istnieją pewne argumenty, które są dostępne dla każdego polecenia.

  • Argument --help wyświetla informacje referencyjne interfejsu wiersza polecenia o poleceniach oraz ich argumentach i wyświetla dostępne podgrupy i polecenia.
  • Argument --output zmienia format danych wyjściowych. Dostępne formaty danych wyjściowych to json, jsonc (kolorowe dane JSON), tsv (wartości rozdzielane tabulatorami), table (tabele ASCII z możliwością odczytu przez człowieka) i yaml. Domyślnie interfejs wiersza polecenia zwraca format 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.
  • Argument --query używa języka zapytań JMESPath, aby filtrować dane wyjściowe zwrócone z usług platformy Azure. Aby dowiedzieć się więcej na temat zapytań, zobacz Artykuł Query command results with Azure CLI and the JMESPath tutorial (Wykonywanie zapytań za pomocą interfejsu wiersza polecenia platformy Azure i samouczek JMESPath).
  • Argument --verbose wyświetla informacje o zasobach utworzonych na platformie Azure podczas operacji oraz inne przydatne informacje.
  • Argument --debug drukuje nawet więcej informacji o operacjach interfejsu wiersza polecenia, używanych na potrzeby debugowania. Jeśli znajdziesz usterkę, podaj dane wyjściowe wygenerowane z flagą --debug podczas przesyłania raportu o usterce.

Tryb interaktywny

Interfejs wiersza polecenia oferuje tryb interaktywny, który automatycznie wyświetla informacje pomocy i ułatwia wybór podpoleceń. W tryb interaktywny wchodzi się za pomocą polecenia az interactive.

az interactive

Aby uzyskać więcej informacji o trybie interaktywnym, zobacz Tryb interaktywny interfejsu wiersza polecenia platformy Azure.

Istnieje również wtyczka programu Visual Studio Code, która oferuje środowisko interaktywne, w tym autouzupełnianie i dokumentację aktywowaną kursorem myszy.

Nauka podstaw interfejsu wiersza polecenia za pomocą samouczków i przewodników Szybki Start

Aby dowiedzieć się, jak używać interfejsu wiersza polecenia platformy Azure, wypróbuj szczegółowy samouczek dotyczący konfigurowania maszyn wirtualnych i używania możliwości interfejsu wiersza polecenia do wykonywania zapytań dotyczących zasobów platformy Azure.

Dostępne są także przewodniki Szybki start dotyczące innych popularnych usług.

Prześlij opinię

Chętnie poznamy Twoją opinię dotyczącą interfejsu wiersza polecenia, która pomoże nam wprowadzić ulepszenia i usunąć błędy. Możesz zgłosić problem w usłudze GitHub lub użyć wbudowanych funkcji interfejsu wiersza polecenia, aby pozostawić ogólną opinię za pomocą polecenia az feedback .

az feedback

Zobacz też