Megosztás a következőn keresztül:


Áttekintés: Az Azure CLI terminológiája és támogatási szintjei

Ez a cikk az Azure CLI-terminológiát ismerteti. Vannak szintaxisösszetevők, hivatkozástípusok és állapotok.

Az Azure CLI szintaxisösszetevői

Az Azure CLI szintaxisa csoportok, hivatkozások, parancsok és paraméterek kombinációja. A teljes hivatkozási parancsot gyakran parancsnak nevezik.

Azure-szolgáltatás Referenciacsoport Referencia alcsoport(ok) Parancs Teljes hivatkozási parancs Példák paraméterre
Azure CLI az config az config --local, --output -o
Azure-hálózat az network application-gateway létrehozás az network application-gateway create --name, --resource-group, --capacity
Azure DevOps az pipelines ügynök list az pipelines agent list --pool-id, --agent-name, --demands

A referencia-alcsoportok több szinttel is rendelkezhetnek, például az network application-gateway private-link ip-config add

Referenciacsoport 1. alcsoport 2. alcsoport 3. alcsoport Parancs
hálózat application-gateway private-link ip-config add

A referenciaparancsok teljes listáját az A–Z referencialista tartalmazza.

Mi az a referenciatípus?

Az Azure CLI-parancsok vagy az alapvető Azure CLI-szolgáltatás részei, vagy bővítmények. A bővítmények opcionális bővítmények. A referenciatípus az itt leírt kiadási ütemezést, állapotot és telepítési módszert határozza meg:

Időszak Alapvető Mellék
Hivatkozások Az elsődleges Azure CLI szolgáltatás része Nem kötelező referenciaparancsok, amelyeket telepíteni kell
Telepítés Az MSI-telepítővel közösen Egyénileg az az extension add
Mentesít Ütemezés szerint Új funkciók vagy frissítések elérhetővé válása
Állapot Lehet ga (általánosan elérhető), előzetes verzió vagy elavult A ga, az előzetes verzió vagy az elavult is lehet

A parancscsoportok listájának lekéréséhez futtassa a parancsokat az. A bővítmények listájához használja az az extension list-available --output table parancsokat.

# Get list of all command groups
az

# Get list of extensions
az extension list-available --output table

Alapvető

A parancssori felület állandó részeként közzétett Azure CLI-hivatkozásokat alaphivatkozásoknak nevezzük. Az összes alapvető hivatkozás az Azure CLI-vel települ, és nem választhatja ki a hivatkozások részhalmazát. Ha az Azure Cloud Shellen keresztül futtatja a parancssori felületet, az alapvető hivatkozások mindig naprakészek.

Mellék

A bővítmények nem a parancssori felület részeként, hanem parancssori felületi parancsokként futnak. Egyes bővítmények az Azure CLI állandó részét képezik, de a bővítmények gyakran hozzáférést biztosítanak az előzetes és a kísérleti parancsokhoz. Egyetlen referenciacsoport, például az iot hub, mag- és bővítményparancsokkal is rendelkezhet. Bemutatunk két példát:

Teljes hivatkozási parancs Is Core Bővítmény
az iot hub list igen
az iot hub job list igen

A rendszer arra kéri, hogy első használatkor telepítsen egy bővítményt. A bővítményt az az extension add parancs futtatásával is telepítheti.

További információ a bővítményhivatkozásokról, beleértve a telepítést és a frissítést a Use bővítményekben az Azure CLI-vel. A bővítmény-referenciaparancsok teljes listáját az Azure CLI elérhető bővítményei között találja.

Mi a hivatkozás állapota?

A referenciatípustól függetlenül az Azure CLI-hivatkozások három állapotkategóriába sorolhatók: ga (általánosan elérhető), nyilvános előzetes verzió vagy elavult. Ez a referenciaparancs állapota (nem típus), amely meghatározza a stabilitást.

FE Nyilvános előzetes verzió Elavult
Stabilitás Állandó Az ügyfél visszajelzésére reagálva változhat. A Microsoft Azure Previews feltételei érvényesek. A rendszer eltávolítja.

Feljegyzés

A nyilvános előzetes verziót vagy az elavultságot jelző figyelmeztetések az Azure CLI parancs kimenetének részét képezik, és elvárásnak kell lenniük.

Az egyetlen hivatkozás legtöbb parancsa és paramétere egyetlen állapotú, de nem mindig. A ga-referencia, amely több parancsot kínál, ga és előzetes verziójú referenciaparancsokkal is rendelkezhet. Mivel új paramétereket adnak hozzá a funkciók növeléséhez, egyetlen parancs is rendelkezhet olyan paraméterekkel, amelyek különböző állapotkategóriákba tartoznak. Az alábbi példahivatkozások különböző állapotúak:

Teljes hivatkozási parancs Paraméterek Típus FE Nyilvános előzetes verzió Elavult
az network dns zone list Mind Alapvető igen
az network dns zone create --name, --resource-group, --if-none-match, --parent-name Alapvető igen
--existingParameter5 Alapvető igen
--newParameter6 Alapvető igen
az network vhub list Mind Mellék igen
az network vhub create --address-prefix, --name, --resource-group, -vwan, --location, --sku Mellék igen
--exsitingParameter7 Mellék igen
--newParameter8 Mellék igen
az network firewall create Mind Mellék igen

A fenti táblázat csak egy példa, és nem reprezentatív a jelenlegi referenciaállapotokra.az network

Lásd még