Aracılığıyla paylaş


Azure CLI'da genel parametrelerle çalışma

Azure CLI başvuru komutlarıyla çalışırken, çoğu komut için kullanılabilir mevcut parametreler vardır. Bu bağımsız değişkenler neredeyse tüm Azure CLI başvuru komutlarında ortak olduğundan "genel parametreler" olarak adlandırılır.

--help küresel parametre

Bir başvuru grubu veya komutu hakkında bilgi almak için genel parametresini --help kullanın. --help parametresi, kullanılabilir alt gruplar 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 küresel parametre

Global parametreyi --verbose başvuru komutunuza ekleyerek kaydedici hakkında daha ayrıntılı bilgi edinin. Ayrıntılı çıktı, belirli komutların neden diğerlerinden daha uzun sürdüğünü anlamaya çalışırken yararlıdır.

az group create --name myResourceGroup --location eastus --verbose 

Burada gösterilen konsol çıktısında, alanlar kısaltma amacıyla çıkarılmıştır. Ancak, yürütme süresiyle ilgili ek bilgileri not edin.

{...}
Command ran in 1.413 seconds (init: 0.487, invoke: 0.926)

--debug küresel 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. Ayrıca, hata raporu gönderirken --debug ile oluşturulan çıktıyı 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 küresel parametre

Hata ayıklama işlemi sırasında --only-show-errors genel parametresini kullanarak bir referans 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 küresel 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 küresel 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:

Uyarı

Çı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 küresel parametre

Çıkış konsolunun filtrelemeniz gereken çok miktarda bilgiyi görüntüleyebileceği zamanlar olabilir. 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çmenize ve değiştirmenize olanak tanıyan bir JSON sorgu dilidir.

Bu örnek, --query ekleyerek 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.

Ayrıca bakınız