Bevezetés az Azure parancssori felületének használatábaGet started with Azure CLI

Üdvözli Önt az Azure CLI!Welcome to the Azure CLI! Ez a cikk bemutatja a CLI-t, és segít a gyakori feladatok elvégzésében.This article introduces the CLI and helps you complete common tasks.

Megjegyzés

A szkriptekben és a Microsoft dokumentációs webhelyén a(z) bash felülethez való példák szerepelnek.In scripts and on the Microsoft documentation site, Azure CLI examples are written for the bash shell. Az egysoros példák bármelyik platformon futtathatók.One-line examples will run on any platform. A hosszabb, sorfolytatásokat (\) vagy változó-hozzárendeléseket tartalmazó példákat módosítani kell, hogy más felületeken, például a PowerShell-lel is használhatók legyenek.Longer examples which include line continuations (\) or variable assignment need to be modified to work on other shells, including PowerShell.

Telepítés vagy futtatás az Azure Cloud ShellbenInstall or run in Azure Cloud Shell

Az Azure CLI-használat megkezdésének a legegyszerűbb módja, ha egy Azure Cloud Shell-környezetben, a böngészője segítségével futtatja.The easiest way to get started with the Azure CLI is by running it in an Azure Cloud Shell environment through your browser. A Cloud Shellről a Bash Azure Cloud Shellben való használatát ismertető rövid útmutatóból tudhat meg többet.To learn about Cloud Shell, see Quickstart for Bash in Azure Cloud Shell.

Ha készen áll a parancssori felület telepítésére, tekintse meg a telepítési útmutatót.When you're ready to install the CLI, see the installation instructions.

Miután az első alkalommal telepítette a CLI-t, győződjön meg arról, hogy a telepítve van, és hogy a megfelelő verziót futtatta 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.

Megjegyzés

Ha a klasszikus Azure üzemi modellt használja, az Azure klasszikus parancssori felületét telepítse.If you're using the Azure classic deployment model, install the Azure classic CLI.

BejelentkezésSign in

Mielőtt használatba vehetné a CLI-parancsokat a helyi telepítésen, be kell jelentkeznie az az login paranccsal.Before using any CLI commands with a local install, you need to sign in with az login.

  1. Futtassa a következő parancsot: login.Run the login command.

    az login
    

    Ha a parancssori felület megnyithatja az alapértelmezett böngészőt, akkor az egy Azure-beli bejelentkezési oldal betöltésével végezhető el.If the CLI can open your default browser, it will do so and load an Azure sign-in page.

    Ellenkező esetben nyisson meg egy böngészőt https://aka.ms/devicelogin , és adja meg a terminálon megjelenő engedélyezési kódot.Otherwise, open a browser page at https://aka.ms/devicelogin and enter the authorization code displayed in your terminal.

  2. A böngészőben jelentkezzen be fiókja hitelesítő adataival.Sign in with your account credentials in the browser.

A bejelentkezést követően megjelenik az Azure-fiókjához társított előfizetések listája.After logging in, you see a list of subscriptions associated with your Azure account. Az előfizetési adatok isDefault: true az aktuálisan aktivált előfizetés a bejelentkezés után.The subscription information with isDefault: true is the currently activated subscription after logging in. Egy másik előfizetés kiválasztásához használja az az Account set parancsot az előfizetés-azonosítóval a következőre való váltáshoz:.To select another subscription, use the az account set command with the subscription ID to switch to. További információ az előfizetés kiválasztásáról: több Azure-előfizetés használata.For more information about subscription selection, see Use multiple Azure subscriptions.

Nem interaktív módok is rendelkezésre állnak a bejelentkezéshez, amelyekről részletesen az Azure CLI-vel történő bejelentkezést ismertető részben olvashat.There are ways to sign in non-interactively, which are covered in detail in Sign in with Azure CLI.

Gyakori parancsokCommon commands

Ez a táblázat néhány, a CLI-ben gyakran használt parancsot és a referenciadokumentációjukra mutató hivatkozásokat tartalmaz.This table lists some common commands used in the CLI and links to their reference documentation.

Erőforrás típusaResource type Azure CLI parancscsoportAzure CLI command group
ErőforráscsoportResource group az groupaz group
Virtuális gépekVirtual machines az vmaz vm
TárfiókokStorage accounts az storage accountaz storage account
Key VaultKey Vault az keyvaultaz keyvault
WebalkalmazásokWeb applications az webappaz webapp
SQL-adatbázisokSQL databases az sql serveraz sql server
CosmosDBCosmosDB az cosmosdbaz cosmosdb

Parancsok kereséseFinding commands

A CLI-ben elérhető parancsok csoportok parancsaiként vannak rendezve.Commands in the CLI are organized as commands of groups. Minden csoport egy Azure-szolgáltatást jelöl, és a parancsok ezen a szolgáltatásra vonatkozóan hajtanak végre műveletet.Each group represents an Azure service, and commands operate on that service.

A parancsok kereséséhez használja az az find parancsot.To search for commands, use az find. Ha például a secret kifejezést tartalmazó parancsnevekre kíván rákeresni, használja az alábbi parancsot:For example, to search for command names containing secret, use the following command:

az find secret

A --help argumentummal kérje le egy csoport parancsainak és alcsoportjainak teljes listáját.Use the --help argument to get a complete list of commands and subgroups of a group. Például a hálózati biztonsági csoportok (NSG-k) használatára szolgáló parancssori felületi parancsok kereséséhez:For example, to find the CLI commands for working with Network Security Groups (NSGs):

az network nsg --help

A CLI teljes körű parancssori kiegészítési funkcióval rendelkezik a bash felületen lévő parancsokhoz.The CLI has full tab completion for commands under the bash shell.

Globálisan elérhető argumentumokGlobally available arguments

Bizonyos argumentumok minden parancshoz elérhetők.There are some arguments that are available for every command.

  • A --help kinyomtatja a parancsokkal és azok argumentumaival kapcsolatos CLI-információkat, valamint listázza az elérhető alcsoportokat és parancsokat.--help prints CLI reference information about commands and their arguments and lists available subgroups and commands.
  • Az --output módosítja a kimenet formátumát.--output changes the output format. Az elérhető kimeneti formátumok a következők: json, jsonc (színes JSON), tsv (tabulátorral tagolt értékek), table (emberi olvashatóságú ASCII-táblázatok) és yaml.The available output formats are json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables), and yaml. Alapértelmezés szerint a CLI a következő kimenetet használja: json.By default the CLI outputs json. Az elérhető kimeneti formátumokkal kapcsolatos további információért lásd: Az Azure CLI kimeneti formátumai.To learn more about the available output formats, see Output formats for Azure CLI.
  • A --query a JMESPath lekérdezi nyelv segítségével szűri az Azure-szolgáltatások által visszaadott kimenetet.--query uses the JMESPath query language to filter the output returned from Azure services. A lekérdezésekkel kapcsolatos további információkért lásd: lekérdezési parancs eredményei az Azure CLI-vel és a JMESPath oktatóanyaggal.To learn more about queries, see Query command results with Azure CLI and the JMESPath tutorial.
  • A --verbose az Azure-ban egy művelet során létrehozott erőforrásokkal kapcsolatos adatokat és egyéb hasznos információkat nyomtat ki.--verbose prints information about resources created in Azure during an operation, and other useful information.
  • A --debug további, hibaelhárítási célokra használható információkat nyomtat ki a CLI-műveletekről.--debug prints even more information about CLI operations, used for debugging purposes. Ha hibát talál, akkor a --debug jelölővel létrehozott kimenetet küldje el a hibajelentéssel együtt.If you find a bug, provide output generated with the --debug flag on when submitting a bug report.

Interaktív módInteractive mode

A CLI által biztosított interaktív mód automatikusan megjeleníti a súgó információit és egyszerűbbé teszi az almenüpontok kiválasztását.The CLI offers an interactive mode that automatically displays help information and makes it easier to select subcommands. Az az interactive paranccsal léphet be az interaktív módba.You enter interactive mode with the az interactive command.

az interactive

Az interaktív móddal kapcsolatos további információért lásd: Azure CLI – interaktív mód.For more information on interactive mode, see Azure CLI Interactive Mode.

Emellett az interaktív élményt biztosító Visual Studio Code beépülő modul is a rendelkezésére áll, amely magában foglalja az automatikus kitöltés és a kattintás nélkül megjeleníthető dokumentáció szolgáltatást.There's also a Visual Studio Code plugin that offers an interactive experience, including autocomplete and mouse-over documentation.

A CLI alapjainak megismerése rövid útmutatók és oktatóanyagok segítségévelLearn CLI basics with quickstarts and tutorials

Az Azure CLI használatának megkezdéséhez tekintsen meg egy részletes oktatóanyagot a virtuális gépek beállításáról, valamint arról, hogy a CLI-ben rejlő lehetőségek miként használhatók az Azure-erőforrások lekérdezésére.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.

Egyéb népszerű szolgáltatásokhoz is elérhetők rövid útmutatók.There are also quickstarts for other popular services.

Visszajelzés küldéseGive feedback

Szívesen fogadjuk a CLI-vel kapcsolatos visszajelzéseit, amelyek segítségével továbbfejleszthetjük a szolgáltatást és kijavíthatjuk a hibákat.We welcome your feedback for the CLI to help us make improvements and resolve bugs. A githubon egy problémát is megadhat, vagy a CLI beépített funkcióival az az feedback paranccsal általános visszajelzést hagyhat.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

Lásd mégSee also