Az Azure CLI használatának első lépései
Üdvözli az Azure Parancssori felület (CLI)! Ez a cikk bemutatja a parancssori felületet, és segít a gyakori feladatok elvégzésében.
Telepítés vagy futtatás az Azure Cloud Shellben
Az Azure CLI használatának legegyszerűbb módja, ha egy Bash-környezetet futtat az Azure Cloud Shellben a böngészőn keresztül. 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 az Azure CLI telepítésére, tekintse meg a Windows, Linux, macOS és Docker tároló telepítési utasításait . Ha a klasszikus Azure üzemi modellt használja, az Azure klasszikus parancssori felületét telepítse.
Ellenőrizze a verziót a futtatással az --version
. Az Azure Cloud Shell mindig az Előre telepített Azure CLI legújabb verzióját használja.
az version
Bejelentkezés az Azure CLI-be
Mielőtt bármely Azure CLI-parancsot helyi telepítéssel használ, be kell jelentkeznie az az login használatával.
Futtassa a következő parancsot:
az login
.az login
Ha az Azure CLI meg tudja nyitni az alapértelmezett böngészőt, elindítja az engedélyezési kódfolyamatot, és megnyitja az alapértelmezett böngészőt egy Azure-bejelentkezési oldal betöltéséhez.
Ellenkező esetben elindítja az eszköz kódfolyamatát , és arra utasítja, hogy nyisson meg egy böngészőlapot a következő helyen https://aka.ms/devicelogin: . Ezután adja meg 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özkód-folyamatot az login --use-device-code használatával.
A böngészőben jelentkezzen be fiókja hitelesítő adataival.
A bejelentkezés után megjelenik az Azure-fiókjához társított előfizetések listája. Az előfizetés adatai isDefault: true
a bejelentkezés után jelenleg aktivált előfizetések. Másik előfizetés kiválasztásához használja az az account set parancsot a kívánt fiók előfizetés-azonosítójával. Az előfizetés kiválasztásáról további információt az Azure-előfizetések kezelése című témakörben talál.
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.
Parancsok keresése
Az Azure CLI-parancsok parancscsoportokként vannak rendszerezve. Minden csoport egy Azure-szolgáltatás egy területét jelöli. A parancscsoportok megkeresésére két lehetőség áll rendelkezésre:
Használja az az find parancsot. Ha például a
vm
kifejezést tartalmazó parancsnevekre kíván rákeresni, használja az alábbi parancsot:az find vm
--help
Az argumentum használatával lekérheti a referenciacsoporton belüli alcsoportok teljes listáját. Ez a példa a virtuális gépek összes alcsoportjának értékét adja vissza:az vm --help
Íme egy példakimenet a rövidség kedvéért kihagyott sorokkal:
Subgroups: application : Manage applications for VM. availability-set : Group resources into availability sets. boot-diagnostics : Troubleshoot the startup of an Azure Virtual Machine. ...
Íme egy másik példa, amely megkeresi a virtuális gépek rendelkezésre állási csoportokba való csoportosítására szolgáló Azure CLI-parancsokat, a következő alcsoportot
az vm
:az vm availability-set --help
A hivatkozási parancs paraméterlistáinak és parancs-példáinak lekérésére is használható
--help
.az vm create --help
Íme egy példakimenet a rövidség kedvéért kihagyott sorokkal:
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 ...
Használja az A– Z referenciaindexet , amely betűrendbe sorolja az összes parancscsoportot.
Közzétett minták és cikkek keresése
Ha inkább az Azure CLI szintaxisát szeretné megtanulni a tesztelt közzétett példák megtekintésével, a cikk tartalmának két indexe van:
Minták indexE-ből Z-be. A mintaindex az Azure CLI-minták listáját tartalmazza tárgyterület, referenciacsoport és GitHub-adattár szerint rendezve.
Cikkindex A–Z. A billentyűparancsokkal
find
Ctrl + F
gyorsan átugrahat arra a hivatkozási parancscsoportra, amelyben érdeklődik. A cikkindex például a következőhözaz vm
hasonlóan néz ki:Referencia alcsoport Referenciahasználatot bemutató Azure CLI-cikk az vm Kimeneti formátumok az Azure CLI-parancsokhoz Változók használata az Azure CLI-parancsokban Virtuálisgép-információk lekérése lekérdezésekkel {További cikkek itt.} az vm aem Az Azure-beli virtuálisgép-bővítmény új verziója SAP-megoldásokhoz Az Azure-beli virtuálisgép-bővítmény standard verziója SAP-megoldásokhoz az vm application {...}
Tabulátor kitöltésének használata
A parancssori felület teljes lapkiegészítéssel rendelkezik a Bash-környezet parancsaihoz. Ha engedélyezni szeretné a lapkiegészítést PowerShell-környezetben, olvassa el a Lapkiegészítés engedélyezése a PowerShellben című témakört.
Vegye figyelembe a globálisan elérhető argumentumokat
Vannak olyan argumentumok, amelyek a legtöbb 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
(Tab-Separated Values),table
(human-readable ASCII tables) é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. Használható például annak a REST API-nak a azonosítására, amelyet a végrehajtott parancs invokált alatta, és a szolgáltatástól kapott válasz.--subscription
az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetés beállításával kapcsolatos további információkért lásd : Azure-előfizetések kezelése az Azure CLI-vel.--only-show-errors
letiltja a parancs kimenetében megjelenő figyelmeztetéseket, és csak a hibákat jeleníti meg.
Interaktív mód használata
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ódról további információt az Azure CLI interaktív módban történő futtatásával kapcsolatban talál.
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.
Az Azure CLI alapjainak elsajátítása rövid útmutatókkal és oktatóanyagokkal
Az Azure CLI használatának megismeréséhez próbálja ki az Azure Storage használata során az alábbi készségeket bemutató előkészítési oktatóanyagunkat:
- Keresse meg és módosítsa az alapértelmezett előfizetést.
- Hozzon létre egy Azure-erőforrást, amely véletlenszerű azonosítót tartalmaz a névben.
- Környezeti változók beállítása.
- Ismerje meg a Bash, a PowerShell és a Cmd közötti szintaxisbeli különbségeket.
- Az Azure CLI referenciaparancsainak hibakeresése.
- Tulajdonságok lekérése helyi JSON-fájlból.. Ez a példa bemutatja, hogyan kérhet le konfigurációs értékeket a fejlesztéshez, a fázishoz és az éles környezethez.
- Több erőforrás törlése szkripttel.
Feljegyzés
A szkriptekben és a Microsoft dokumentációs webhelyén azure CLI-példákat írnak a Bash-rendszerhéjhoz. A legtöbb egysoros példa bármilyen platformon fut. A sor folytatását (\
), változó-hozzárendelést vagy idézőjeleket tartalmazó hosszabb példákat módosítani kell, hogy más rendszerhéjakban, például a PowerShellben is működjenek. A környezetek közötti szintaxisbeli különbségekről további információt a Bash, a PowerShell és a Cmd közötti szintaxisbeli különbségek című témakörben talál .
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. Probléma a GitHubon is elküldhető, vagy a parancssori felület beépített funkcióival általános visszajelzést hagyhat az az feedback paranccsal.
az feedback