Változók használata az Azure CLI-parancsokban
A parancsban közvetlenül megadott értékek mellett többféleképpen is megadhat értékeket:
- Rendszerhéjváltozók használata
- Előfizetés beállítása több parancsban való használatra
- Alapértelmezett értékek létrehozása néhány paraméterhez
Ez a cikk az Azure CLI-parancsok értékeinek megadásának különböző módjait ismerteti.
Előfeltételek
Használja a Bash-környezetet az Azure Cloud Shellben. További információ: A Bash rövid útmutatója az Azure Cloud Shellben.
Ha inkább helyi cli-referenciaparancsokat szeretne futtatni, telepítse az Azure CLI-t. Ha Windows vagy macOS rendszert használ, fontolja meg az Azure CLI Docker-tárolóban való futtatását. További információ: Az Azure CLI futtatása Docker-tárolóban.
Ha helyi telepítést használ, jelentkezzen be az Azure CLI-be az az login parancs futtatásával. A hitelesítési folyamat befejezéséhez kövesse a terminálon megjelenő lépéseket. További bejelentkezési lehetőségekért lásd : Bejelentkezés az Azure CLI-vel.
Amikor a rendszer kéri, először telepítse az Azure CLI-bővítményt. További információ a bővítményekről: Bővítmények használata az Azure CLI-vel.
Futtassa az az version parancsot a telepített verzió és a függő kódtárak megkereséséhez. A legújabb verzióra az az upgrade paranccsal frissíthet.
Rendszerhéjváltozók használata
Az Azure CLI egy rendszerhéjban fut. Ez a cikk Bash-t használ. További információ az egyéb szkriptnyelvekről: Válassza ki a megfelelő Azure parancssori eszközt. A Bash változóival paraméterértékeket adhat át a parancsoknak. A változók Azure CLI-vel való használata lehetővé teszi a parancsok újrafelhasználását, akár darabos, akár szkriptekben.
Ez a példa egy meglévő virtuális gép tárolólemezével azonos típusú új tárolólemezt hoz létre.
# Bash script
# Assign values to variables
MyResourceGroup=ContosoRGforVM
MySubscription="Contoso subscription"
vmName=VM01
# Get a value for a variable based on an existing virtual machine
osType=$(az vm get-instance-view --resource-group $MyResourceGroup \
--name $vmName --subscription "$MySubscription" \
--query 'storageProfile.osDisk.osType' --output tsv)
# Create a disk of the same type by using the variable value
az disk create --resource-group $MyResourceGroup --name DestinationDisk --size-gb 20 --os-type $osType
Ez a példa bemutatja, hogyan rendelhet értékeket az újrafelhasznált változókhoz, például a MyResourceGrouphoz és az osType-hoz. Az az vm get-instance-view parancs és a lekérdezés storageProfile.osDisk.osType a lemez operációs rendszerének típusát adja vissza. A parancs körbefuttatása a parancs visszatérési értékének osTypehozzárendelésével$(). A JMESPath-lekérdezésekről és a JMESPath-lekérdezésekről --query további információt az Azure CLI-parancs kimenetének JMESPath-lekérdezéssel történő lekérdezése című témakörben talál.
Ha egy másik parancsból egy változóhoz rendel értéket, győződjön meg arról, hogy a parancs kompatibilis kimeneti formátumot használ. Az az vm get-instance-view parancs a tsv kimeneti formátumot használja. Ez a beállítás további formázás, kulcsok és egyéb szimbólumok nélkül ad vissza értékeket. Egyes kimeneti formátumok például struktúra vagy karakterek, például idézőjelek. További információkért tekintse meg az Azure CLI-parancsok kimeneti formátumait.
Ebben a példában a MySubscription változónak idézőjelekben kell lennie. A változó értéke szóközöket tartalmaz, amelyeket a parancs nem tud elemezni. Ha csak előfizetés-azonosítókkal dolgozik, nem kell idézőjeleket használnia.
Előfizetés beállítása
Számos parancshoz egy adott előfizetés szükséges. Az Azure-erőforrások az előfizetésekben található erőforráscsoportokban léteznek. Az Azure CLI egy alapértelmezett előfizetést használ munkamenet közben. Az aktuális előfizetési érték megtekintéséhez futtassa az az account show parancsot:
az account show --output table
Lehet, hogy csak egy előfizetéshez van hozzáférése. További információ: Azure-előfizetések használata az Azure CLI-vel Az az account set paranccsal állíthatja be az aktuális előfizetést:
az account set --subscription "My Demos"
Az előfizetés beállítása után kihagyhatja a paramétert --Subscription . További információ: Azure-előfizetések használata az Azure CLI-vel.
Alapértelmezett értékek létrehozása
Egyes paraméterek értékeit az az config set paranccsal állíthatja be . Ez a példa beállít egy alapértelmezett erőforráscsoportot:
az config set defaults.group=ContosoRGforVM
A parancs futtatása után a következő parancs futtatásával létrehozhat egy tárfiókot a ContosoRGforVM erőforráscsoportban:
az storage account create --name storage135 --location eastus --sku Standard_LRS
Figyelje meg, hogy nincs megadva erőforráscsoport a parancsban. További információ: Alapértelmezett erőforráscsoport beállítása.
Tipp.
A paraméterek értékeit különböző módokon lekért parancsok zavaróak lehetnek. Ha egy parancs váratlan eredményt ad, például nem talál erőforráscsoportot, előfordulhat, hogy van egy alapértelmezett érték.
Ha hibát tapasztal, futtassa újra a parancsot a megadott paraméterrel és értékkel. A paraméterek explicit értéke mindig elsőbbséget élvez a többi beállítással szemben.
Így több paraméter értékeit is megadhatja. További információ: Azure CLI-konfiguráció.
Az erőforrások eltávolítása
Ha a cikkben szereplő parancsok bármelyikének kipróbálásához létrehozott erőforrásokat, az az group delete paranccsal távolíthatja el őket:
az group delete --name ContosoRGforVM
az group delete --name ContosoStorageRG
Ez a parancs eltávolítja a csoportot és az összes erőforrást, amelyet egyszerre tartalmaz.
