Overzicht: Azure CLI-referentietypen en -status

De Azure CLI heeft verschillende referentietypen, die soms door elkaar worden beschreven met de referentiestatus. In dit artikel wordt het verschil tussen een Azure CLI-type en een status uitgelegd en vindt u informatie over het werken met beide.

Azure CLI-syntaxisonderdelen

De Azure CLI-syntaxis is een combinatie van verwijzingen, opdrachten en parameters. De volledige referentieopdracht wordt vaak opdracht genoemd.

Azure-service Referentie Referentiesubservice Opdracht Opdracht voor volledige verwijzing Parametervoorbeelden
Azure CLI az config az config --local, --output -o
Azure-netwerk az network application-gateway maken az network application-gateway create --name, --resource-group, --capacity
Azure DevOps Server az pipelines agent list az pipelines agent list --pool-id, --agent-name, --demands

Wat zijn verwijzingstypen?

Een verwijzingstype geeft aan of de referentieopdracht deel uitmaakt van de primaire Azure CLI-service, of dat het een optionele invoeg-on is. Er zijn twee typen Azure CLI-referentieopdrachten: core en extensie.

Kern Extensie
Referenties Maken deel uit van de primaire Azure CLI-service Zijn optionele referentieopdrachten die moeten worden geïnstalleerd
Installeren Samenwerken met het MSI-installatieprogramma Afzonderlijk met az extension add
Vrijgegeven Volgens een schema Zodra er nieuwe functies of updates beschikbaar komen
Status Kan ga (algemeen beschikbaar), preview of experimenteel zijn Kan ook ga, preview of experimenteel zijn

Alle Azure CLI-verwijzingen kunnen worden uitgevoerd in Windows, macOS, Linux, Docker en Azure Cloud Shell.

Kern

Azure CLI-verwijzingen die zijn gepubliceerd als een permanent onderdeel van de CLI worden kernverwijzingen genoemd. Alle kernverwijzingen worden geïnstalleerd met de Azure CLI en u kunt geen subset van verwijzingen kiezen. Als u de CLI via Azure Cloud Shell, zijn de kernverwijzingen altijd up-to-date. Zie Core-referentielijst voor de Azure CLI voor een volledige lijst met kernverwijzingsopdrachten.

Extensie

Extensies worden niet verzonden als onderdeel van de CLI, maar worden uitgevoerd als CLI-opdrachten. Sommige extensies zijn een permanent onderdeel van de Azure CLI, maar vaak biedt een extensie u toegang tot privépreviews en experimentele opdrachten. Eén verwijzing, zoals az iot hub, kan zowel kernopdrachten als extensieopdrachten bevatten. Hier zijn vier voorbeelden:

Opdracht voor volledige verwijzing Is Core Is extensie
az iot hub list ja
az iot hub query ja
az iot hub certificate create ja
az iot hub device identify create ja

Belangrijk

U moet een extensie installeren voordat u deze kunt gebruiken door de opdracht az extension add uit te voeren.

Meer informatie over extensieverwijzingen, waaronder installatie en bijwerken, vindt u in Extensies gebruiken met de Azure CLI. Zie Beschikbare extensies voor de Azure CLI voor een volledige lijst met extensieverwijzingsopdrachten.

Wat is referentiestatus?

Ongeacht het type kunnen Azure CLI-verwijzingen worden onderverdeeld in drie statuscategorieën: GA (algemeen beschikbaar), openbare preview of experimenteel. Het is de referentieopdrachtstatus, niet het type, die het stabiliteits- en ondersteuningsniveau bepaalt.

Algemene beschikbaarheid Openbare preview Experimenteel
Stabiliteit Permanent Kan worden gewijzigd als reactie op feedback van klanten. Is onderhevig aan de voorwaarden van Microsoft Azure Previews. Kan worden gewijzigd als reactie op feedback van klanten. Wordt vaak gemigreerd naar openbare preview. Kan worden verwijderd.
Ondersteuningsniveau Volledig Gedeeltelijk Geen

Hoewel de meeste opdrachten en parameters voor één verwijzing één status hebben, is dit niet altijd het geval. Een ga-verwijzing die wordt ontwikkeld om meer opdrachten te bieden, kan ga-, preview- en experimentele referentieopdrachten bevatten. Als er nieuwe parameters worden toegevoegd om de functionaliteit te vergroten, kan één opdracht ook parameters hebben die onder verschillende statuscategorieën vallen. Hier volgen voorbeeldverwijzingen met verschillende statussen:

Opdracht voor volledige verwijzing Parameters Type Algemene beschikbaarheid Openbare preview Experimenteel
az network dns zone list Alles Kern ja
az network dns zone create --name, --resource-group, --if-none-match, --parent-name Kern ja
--newFutureParameter1 Kern ja
--newFutureParameter2 Kern ja
az network vhub list Alles Extensie ja
az network vhub create --address-prefix, --name, --resource-group, -vwan, --location, --sku Extensie ja
--newFutureParameter1 Extensie ja
--newFutureParameter2 Extensie ja
az network firewall create Alles Extensie ja

Notitie

Waarschuwingen die een openbare preview of experimenteel aangeven, maken deel uit van de uitvoer van de Azure CLI-opdracht en moeten worden verwacht.

Zie ook