Globális paraméterek használata az Azure CLI-ben
Amikor az Azure CLI referenciaparancsaival dolgozik, a legtöbb parancshoz elérhető argumentumok állnak rendelkezésre. Ezeket az argumentumokat "globális paramétereknek" nevezzük, mivel szinte minden Azure CLI-referenciaparancs esetében gyakoriak.
--help
globális paraméter
Ha egy referenciacsoportról vagy parancsról szeretne információt kapni, használja a --help
globális paramétert. A --help
paraméter megjeleníti az Azure CLI referenciaadatait a konzolon, beleértve az elérhető alcsoportokat és paraméterlistákat.
az group create --name myResourceGroup --location eastus --help
Az alábbi konzolkimenetben kihagyott mezők szerepelnek a rövidség kedvéért:
Command
az group create : Create a new resource group.
Arguments
--location -l [Required] : Location. Values from: `az account list-locations`.
You can configure the default location using `az
configure --defaults location=<location>`.
--name --resource-group -g -n [Required] : Name of the new resource group.
--managed-by : The ID of the resource that manages this resource
group.
--tags : Space-separated tags: key[=value] [key[=value] ...].
Use "" to clear existing tags.
Global Arguments
--debug : Increase logging verbosity to show all debug logs.
--help -h : Show this help message and exit.
--only-show-errors : Only show errors, suppressing warnings.
Examples
Create a new resource group in the West US region.
az group create -l westus -n MyResourceGroup
--verbose
globális paraméter
További részletes információk a naplózásról, ha hozzáadja a globális paramétert a --verbose
referenciaparancshoz. A részletes kimenet akkor hasznos, ha megpróbálja megérteni, hogy bizonyos parancsok végrehajtása miért tart tovább, mint mások.
az group create --name myResourceGroup --location eastus --verbose
Az alábbi konzolkimenetben a rövidség kedvéért kihagyott mezők vannak megadva, de jegyezze fel a végrehajtási időre vonatkozó további információkat.
{...}
Command ran in 1.413 seconds (init: 0.487, invoke: 0.926)
--debug
globális paraméter
Ha a paraméter további --verbose
részletei nem elegendőek, és meg szeretné tekinteni a teljes naplót, használja a globális paramétert --debug
. Adja meg a hibajelentés elküldésekor létrehozott --debug
kimenetet is.
az group create --name myrResourceGroup --location eastus --debug
Az alábbi konzolkimenetben kihagyott mezők szerepelnek a rövidség kedvéért:
cli.knack.cli: Command arguments: ['group', 'create', '--name', 'myResourceGroup', '--location', 'eastus', '--debug']
cli.knack.cli: __init__ debug log:
[...]
cli.knack.cli: Event: CommandInvoker.OnTransformResult [<function _resource_group_transform at 0x000001D9B72123B0>, <function _x509_from_base64_to_hex_transform at 0x000001D9B7212440>]
cli.knack.cli: Event: CommandInvoker.OnFilterResult []
{...}
[...]
telemetry.process: Return from creating process
telemetry.main: Finish creating telemetry upload process.
--only-show-errors
globális paraméter
A hibakeresés során távolítsa el a hivatkozási parancs által visszaadott figyelmeztetéseket a --only-show-errors
globális paraméter használatával.
az interactive
Kimeneti konzol:
**This command is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus**
Any comments or concerns? You can use the 'feedback' command! We would greatly appreciate it.
A new Recommender is added which can make the completion ability more intelligent and provide the scenario completion!
If you want to disable this feature, you can use 'az config set interactive.enable_recommender=False' to disable it.
A command preload mechanism was added to prevent lagging and command run errors.
You can skip preloading in a single pass by CTRL+C or turn it off by setting 'az config set interactive.enable_preloading=False'
Loading command table... Expected time around 1 minute.
--subscription
globális paraméter
A globális paraméterrel --subscription
beállíthat egy adott előfizetést egy parancshoz. Az alábbi példa az előfizetés azonosítójával módosítja az aktív előfizetést:
az account set --subscription "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--output
globális paraméter
Ha egy parancs kimenetét egy adott formátumban szeretné megjeleníteni, adja meg a --output
globális paramétert. Ebben a példában a kimenet táblázatként jelenik meg:
Feljegyzés
A kimenet elfogadott értékei a következők: json, jsonc, none, table, tsv, yaml és yamlc. Az alapértelmezett kimeneti érték a json.
az vm list --resource-group myResourceGroup --output table
Kimeneti konzol:
Name ResourceGroup Location
------ --------------- ----------
myVm myResourceGroup eastus
A különböző kimeneti formátumokról további információt az Azure CLI-parancsok kimeneti formátumai című témakörben talál.
--query
globális paraméter
Előfordulhat, hogy a kimeneti konzol nagy mennyiségű információt jelenít meg, amelyeket át kell szűrnie. Ehhez a --query
globális paraméterrel hajtson végre egy JMESPath-lekérdezést a parancsok eredményein. A JMESPath a JSON lekérdezési nyelve, amely lehetővé teszi az Azure CLI-kimenetből származó adatok kiválasztását és módosítását.
Ez a példa a virtuális géphez való csatlakozásra jogosult SSH nyilvános kulcsokat adja vissza a következő hozzáadásával --query
:
az vm show --resource-group myResourceGroup --name myVm --query "osProfile.linuxConfigurat
ion.ssh.publicKeys"
Kimeneti konzol:
[
{
"keyData": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC7WbiMEsB0iwdGPjeGXs3UWFtzbCkUwtIxzkIOpEtlqkLGa0XQdvwhzok6szq6Ycx/f4cfid/yrmBPtzmxdQnGeCy2FOcVIzp+SkjIUg/Ez2YyDcMb60u66QUmHPRyhipJ/PDZROt6O0092qfTkTjB+7hLRiZzV2raLjiQ95eV0AXUP+Gsvdo/7ytqWNIm3iQTWbQ/GwSg+p0v+kmZELIbrxo845dambSpgBL8g0wCUZaptru3ZHo9m0UWbFPASVJKauhfPCSVPQCaOCaAdB01Ih8QDVRCazT+jyV6GgTwUIXVQthVBbt56ibhuSUdf0cWF8IVncjH+WXexVAhQw0j",
"path": "/home/daphnema/.ssh/authorized_keys"
}
]
A parancskimenet lekérdezésével kapcsolatos további információkért tekintse meg az Azure CLI-parancs kimenetének JMESPath-lekérdezéssel történő lekérdezését ismertető témakört.