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 --version
verzió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.
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.
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őkjson
: ,jsonc
(színezett JSON),tsv
(tabulátorral tagolt értékek),table
(emberi olvasásra alkalmas ASCII-táblázatok) ésyaml
. 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.
- Tárfiók létrehozása az Azure parancssori felülettel
- Objektumok továbbítása Azure Blob-tárolókra és -tárolókról a CLI használatával
- Önálló Azure SQL-adatbázis létrehozása az Azure CLI használatával
- Azure Database for MySQL kiszolgáló létrehozása az Azure CLI használatával
- Azure-adatbázis létrehozása PostgreSQL-kiszolgálóhoz az Azure CLI használatával
- Python-webapp létrehozása az Azure-ban
- Egyéni Docker Hub-rendszerkép használata az Azure Web Apps for Containers szolgáltatásban
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