Bevezetés az Azure parancssori felületének használatába

Üdvözli az Azure Command-Line Interface (CLI)! Ez a cikk bemutatja a parancssori felületet, és segít a gyakori feladatok elvégzésében.

Megjegyzés

A szkriptekben és a Microsoft dokumentációs webhelyén a(z) bash felülethez való példák szerepelnek. Az egysoros példák bármelyik platformon futtathatók. 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.

Telepítés vagy futtatás az Azure Cloud Shellben

Az Azure CLI használatának megismeréséhez a legegyszerűbben úgy ismerheti meg, ha egy Azure Cloud Shell-környezetben futtatja a böngészőben. A Cloud Shellről a Bash Azure Cloud Shellben való használatát ismertető rövid útmutatóból tudhat meg többet.

Ha készen áll a parancssori felület telepítésére, tekintse meg a telepítési útmutatót.

Miután első alkalommal telepítette a parancssori felületet, ellenőrizze, hogy telepítve van-e, és hogy a megfelelő az --versionverziót futtatta-e.

Megjegyzés

Ha a klasszikus Azure üzemi modellt használja, az Azure klasszikus parancssori felületét telepítse.

Bejelentkezés az Azure CLI-be

Mielőtt azure CLI-parancsokat használ egy helyi telepítéssel, be kell jelentkeznie az az login használatával.

  1. Futtassa a következő parancsot: login.

    az login
    

    Ha a parancssori felület meg tudja nyitni az alapértelmezett böngészőt, elindítja az engedélyezési kód folyamatát , és megnyitja az alapértelmezett böngészőt az Azure bejelentkezési oldalának betöltéséhez.

    Ellenkező esetben elindítja az eszköz kódfolyamát , és arra utasítja, hogy nyisson meg egy böngészőlapot https://aka.ms/devicelogin , és írja be a terminálban megjelenő kódot.

    Ha nem érhető el webböngésző, vagy a webböngésző nem nyitható meg, kényszerítheti az eszköz kódfolyamát az az login --use-device-code használatával.

  2. A böngészőben jelentkezzen be fiókja hitelesítő adataival.

Bejelentkezés után megjelenik az Azure-fiókjához társított előfizetések listája. A bejelentkezés után az előfizetés adatai isDefault: true az aktuálisan aktivált előfizetés. Másik előfizetés kiválasztásához használja az az account set parancsot és az előfizetés azonosítóját a váltáshoz. További információ az előfizetés kiválasztásáról: Több Azure-előfizetés használata.

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.

Az Azure parancssori felület gyakori parancsai

Ez a táblázat néhány, a CLI-ben gyakran használt parancsot és a referenciadokumentációjukra mutató hivatkozásokat tartalmaz.

Erőforrás típusa Azure CLI parancscsoport
Erőforráscsoport az group
Virtuális gépek az vm
Tárfiókok az storage account
Key Vault az keyvault
Webalkalmazások az webapp
SQL-adatbázisok az sql server
CosmosDB az cosmosdb

Parancsok keresése

Az Azure CLI-parancsok csoportokparancsaiként vannak rendszerezve. Minden csoport egy Azure-szolgáltatást jelöl, és a parancsok ezen a szolgáltatásra vonatkozóan hajtanak végre műveletet.

A parancsok kereséséhez használja az az find parancsot. Ha például a secret kifejezést tartalmazó parancsnevekre kíván rákeresni, használja az alábbi parancsot:

az find secret

A --help argumentummal kérje le egy csoport parancsainak és alcsoportjainak teljes listáját. Például a hálózati biztonsági csoportok (NSG-k) használatára szolgáló parancssori felületi parancsok kereséséhez:

az network nsg --help

A CLI teljes körű parancssori kiegészítési funkcióval rendelkezik a bash felületen lévő parancsokhoz.

Globálisan elérhető argumentumok

Bizonyos argumentumok minden parancshoz elérhetők.

  • A --help kinyomtatja a parancsokkal és azok argumentumaival kapcsolatos CLI-információkat, valamint listázza az elérhető alcsoportokat és parancsokat.
  • Az --output módosítja a kimenet formátumát. Az elérhető kimeneti formátumok a következők json: , jsonc (színezett JSON), tsv (tabulátorral tagolt értékek), table (emberi olvasásra alkalmas ASCII-táblázatok) és yaml. Alapértelmezés szerint a CLI a következő kimenetet használja: json. Az elérhető kimeneti formátumokkal kapcsolatos további információért lásd: Az Azure CLI kimeneti formátumai.
  • A --query a JMESPath lekérdezi nyelv segítségével szűri az Azure-szolgáltatások által visszaadott kimenetet. A lekérdezésekkel kapcsolatos további információkért tekintse meg a Lekérdezés parancs eredményeit az Azure CLI-vel és a JMESPath oktatóanyaggal.
  • 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.
  • A --debug további, hibaelhárítási célokra használható információkat nyomtat ki a CLI-műveletekről. Ha hibát talál, akkor a --debug jelölővel létrehozott kimenetet küldje el a hibajelentéssel együtt.

Interaktív mód

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. Az az interactive paranccsal léphet be az interaktív módba.

az interactive

Az interaktív móddal kapcsolatos további információért lásd: Azure CLI – interaktív mód.

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.

A CLI alapjainak megismerése rövid útmutatók és oktatóanyagok segítségével

Az Azure CLI használatának megismeréséhez próbáljon ki egy részletes oktatóanyagot a virtuális gépek beállításához és a CLI erejének az Azure-erőforrások lekérdezéséhez való használatához.

Egyéb népszerű szolgáltatásokhoz is elérhetők rövid útmutatók.

Visszajelzés küldése

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. A problémát beküldheti a GitHubon , vagy a CLI beépített funkcióival általános visszajelzést adhat az az feedback paranccsal.

az feedback

Lásd még