Az Azure CLI használatának első lépései

  • Cikk

Ü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.

  1. 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.

  2. 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ő alcsoportotaz 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:

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ők json: , jsonc (színezett JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) é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.

  • --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:

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

Lásd még