Udostępnij za pośrednictwem


Rozpoczynanie pracy z interfejsem wiersza polecenia platformy Azure

Interfejs wiersza polecenia platformy Azure — Zapraszamy! W tym artykule przedstawiono interfejs wiersza polecenia i ułatwia wykonywanie typowych zadań.

Instalowanie lub uruchamianie w usłudze Azure Cloud Shell

Najprostszym sposobem, aby dowiedzieć się, jak używać interfejsu wiersza polecenia platformy Azure, jest uruchomienie środowiska powłoki Bash w usłudze 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 platformy Azure, zapoznaj się z instrukcjami dotyczącymi instalacji kontenerów systemów Windows, Linux, macOS i Docker. Jeśli używasz klasycznego modelu wdrażania platformy Azure, zainstaluj klasyczny interfejs wiersza polecenia platformy Azure.

Sprawdź wersję, uruchamiając polecenie az --version. Usługa Azure Cloud Shell zawsze ma wstępnie zainstalowaną najnowszą wersję interfejsu wiersza polecenia platformy Azure.

az version

Zaloguj się do interfejsu wiersza polecenia platformy Azure

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

  1. Uruchom polecenie az login.

    az login
    

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

    W przeciwnym razie inicjuje przepływ kodu urządzenia i nakazuje otwarcie strony przeglądarki pod adresem https://aka.ms/devicelogin. Następnie wprowadź kod wyświetlany w terminalu.

    Jeśli żadna 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 isDefault: true programem to aktualnie aktywowana subskrypcja po zalogowaniu. Aby wybrać inną subskrypcję, użyj polecenia az account set z identyfikatorem subskrypcji żądanego konta. Aby uzyskać więcej informacji na temat wyboru subskrypcji, zobacz Zarządzanie subskrypcjami platformy Azure.

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

Znajdowanie poleceń

Polecenia interfejsu wiersza polecenia platformy Azure są zorganizowane jako grupy poleceń. Każda grupa reprezentuje obszar usługi platformy Azure. Istnieją dwie opcje znajdowania grup poleceń:

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

    az find vm
    
  • Użyj argumentu , --help aby uzyskać pełną listę podgrup w grupie referencyjnej. Ten przykład zwraca wszystkie podgrupy dla maszyn wirtualnych:

    az vm --help
    

    Oto przykładowe dane wyjściowe z wierszami pominiętymi dla zwięzłości:

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

    Oto inny przykład, który znajduje polecenia interfejsu wiersza polecenia platformy Azure do grupowania maszyn wirtualnych w zestawy dostępności, podgrupę :az vm

    az vm availability-set --help
    

    Służy --help również do pobierania list parametrów i przykładów poleceń dla polecenia referencyjnego.

    az vm create --help
    

    Oto przykładowe dane wyjściowe z wierszami pominiętymi dla zwięzłości:

    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
        ...
    
  • Użyj indeksu odwołania od A do Z, który wyświetla listę wszystkich grup poleceń alfabetycznie.

Znajdowanie opublikowanych przykładów i artykułów

Jeśli wolisz poznać składnię interfejsu wiersza polecenia platformy Azure, zobacz przetestowane przykłady, istnieją dwa indeksy zawartości artykułu:

Korzystanie z uzupełniania kart

Interfejs wiersza polecenia ma pełne uzupełnianie kart dla poleceń w środowisku powłoki Bash. Aby włączyć uzupełnianie kart w środowisku programu PowerShell, zobacz Włączanie uzupełniania kart w programie PowerShell.

Należy pamiętać o dostępnych globalnie argumentach

Istnieją pewne argumenty, które są dostępne dla większości poleceń.

  • 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 czytelne dla 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 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. Można go użyć, na przykład, aby zidentyfikować interfejs API REST, który został wykonany, jest wywoływany pod spodem, a odpowiedź odebrana z usługi.

  • --subscription to nazwa lub identyfikator subskrypcji. Aby uzyskać więcej informacji na temat ustawiania domyślnej subskrypcji, zobacz Zarządzanie subskrypcjami platformy Azure przy użyciu interfejsu wiersza polecenia platformy Azure.

  • --only-show-errors pomija ostrzeżenia w danych wyjściowych polecenia i wyświetla tylko błędy.

Korzystanie z trybu interaktywnego

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 na temat trybu interaktywnego, zobacz Uruchamianie interfejsu wiersza polecenia platformy Azure w trybie interaktywnym.

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

Poznaj podstawy interfejsu wiersza polecenia platformy Azure za pomocą przewodników Szybki start i samouczków

Aby dowiedzieć się, jak używać interfejsu wiersza polecenia platformy Azure, wypróbuj nasz samouczek dołączania, który uczy cię następujących umiejętności podczas pracy z usługą Azure Storage:

Uwaga

W skryptach i witrynie dokumentacji firmy Microsoft przykłady interfejsu wiersza polecenia platformy Azure są napisane dla powłoki Bash. Większość przykładów jednowierszowych będzie działać na dowolnej platformie. Dłuższe przykłady, które obejmują kontynuacje wierszy (\), przypisanie zmiennych lub cudzysłowy , należy zmodyfikować tak, aby działały w innych powłokach, w tym w programie PowerShell. Aby uzyskać więcej informacji na temat różnic składni między środowiskami, zobacz Informacje o różnicach składni między powłoką Bash, programem PowerShell i programem Cmd.

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 przekazać ogólną opinię za pomocą polecenia az feedback .

az feedback

Zobacz też