Aracılığıyla paylaş


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 --querysanal 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.

Ayrıca bkz.