Azure CLI'da genel parametrelerle çalışma
Azure CLI başvuru komutları ile çalışırken, çoğu komut için kullanılabilen bağımsız değişkenler vardır. Bu bağımsız değişkenlere "genel parametreler" adı verilir çünkü neredeyse tüm Azure CLI başvuru komutlarında ortaktır.
--help
global parametre
Bir başvuru grubu veya komutu hakkında bilgi almak için genel parametresini --help
kullanın. parametresi, --help
kullanılabilir alt grup ve parametre listeleri de dahil olmak üzere konsolunuzda Azure CLI başvuru bilgilerini görüntüler.
az group create --name myResourceGroup --location eastus --help
Burada gösterilen aşağıdaki konsol çıkışında kısa süre için atlanmış alanlar var:
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
global parametre
Genel parametreyi --verbose
başvuru komutunuza ekleyerek günlüğe kaydetme hakkında daha ayrıntılı bilgi edinin. Ayrıntılı çıkış, bazı komutların yürütülmesinin neden diğerlerinden daha uzun sürerek çalıştığını anlamaya çalışırken yararlıdır.
az group create --name myResourceGroup --location eastus --verbose
Burada gösterilen aşağıdaki konsol çıkışında kısa süre için atlanmış alanlar var, ancak yürütme süresiyle ilgili ek bilgilere dikkat edin.
{...}
Command ran in 1.413 seconds (init: 0.487, invoke: 0.926)
--debug
global parametre
Parametresinden ek ayrıntılar yeterli değilse ve günlüğün --verbose
tamamını görüntülemek istiyorsanız genel parametresini --debug
kullanın. Hata raporu gönderirken ile --debug
oluşturulan çıkışı da sağlayın.
az group create --name myrResourceGroup --location eastus --debug
Burada gösterilen aşağıdaki konsol çıkışında kısa süre için atlanmış alanlar var:
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
global parametre
Hata ayıklama işlemi sırasında, genel parametresini kullanarak --only-show-errors
bir başvuru komutu tarafından döndürülen uyarıları kaldırın.
az interactive
Çıkış konsolu:
**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
global parametre
Genel parametresini --subscription
kullanarak bir komut için belirli bir abonelik ayarlayabilirsiniz. Aşağıdaki örnek, abonelik kimliğini kullanarak etkin aboneliği değiştirir:
az account set --subscription "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--output
global parametre
Bir komutun çıkışını belirli bir biçimde göstermek için genel parametreyi --output
belirtin. Bu örnekte, çıktı bir tablo olarak gösterilir:
Not
Çıktı için kabul edilen değerler şunlardır: json, jsonc, none, table, tsv, yaml ve yamlc. Varsayılan çıkış değeri json'dır.
az vm list --resource-group myResourceGroup --output table
Çıkış konsolu:
Name ResourceGroup Location
------ --------------- ----------
myVm myResourceGroup eastus
Farklı çıkış biçimleri hakkında daha fazla bilgi edinmek için bkz . Azure CLI komutları için çıkış biçimleri.
--query
global parametre
Çıkış konsolunda bazen filtrelemeniz gereken çok miktarda bilgi görüntülenebilir. Bunu yapmak için genel parametresini kullanarak komutların --query
sonuçlarında bir JMESPath sorgusu yürütebilirsiniz. JMESPath, Azure CLI çıkışından veri seçme ve değiştirme olanağı sağlayan bir JSON sorgu dilidir.
Bu örnek, ekleyerek --query
sanal makineye bağlanma yetkisi olan SSH ortak anahtarlarını döndürür:
az vm show --resource-group myResourceGroup --name myVm --query "osProfile.linuxConfigurat
ion.ssh.publicKeys"
Çıkış konsolu:
[
{
"keyData": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC7WbiMEsB0iwdGPjeGXs3UWFtzbCkUwtIxzkIOpEtlqkLGa0XQdvwhzok6szq6Ycx/f4cfid/yrmBPtzmxdQnGeCy2FOcVIzp+SkjIUg/Ez2YyDcMb60u66QUmHPRyhipJ/PDZROt6O0092qfTkTjB+7hLRiZzV2raLjiQ95eV0AXUP+Gsvdo/7ytqWNIm3iQTWbQ/GwSg+p0v+kmZELIbrxo845dambSpgBL8g0wCUZaptru3ZHo9m0UWbFPASVJKauhfPCSVPQCaOCaAdB01Ih8QDVRCazT+jyV6GgTwUIXVQthVBbt56ibhuSUdf0cWF8IVncjH+WXexVAhQw0j",
"path": "/home/yourName/.ssh/authorized_keys"
}
]
Komut çıktısını sorgulama hakkında daha fazla bilgi edinmek için bkz . JMESPath sorgusu kullanarak Azure CLI komut çıktısını sorgulama.