다음을 통해 공유

Azure CLI에서 전역 매개 변수를 사용하여 작업하는 방법

  • 아티클

Azure CLI 참조 명령을 사용하는 경우 대부분의 명령에 사용할 수 있는 인수가 있습니다. 이러한 인수는 거의 모든 Azure CLI 참조 명령에 공통적으로 사용되므로 "전역 매개 변수"라고 합니다.

--help global 매개 변수

참조 그룹 또는 명령에 대한 정보를 얻으려면 전역 매개 변수를 --help 사용합니다. 매개 변수는 --help 사용 가능한 하위 그룹 및 매개 변수 목록을 포함하여 콘솔에 Azure CLI 참조 정보를 표시합니다.

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

여기에 표시된 다음 콘솔 출력에는 간결성을 위해 생략된 필드가 있습니다.

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 매개 변수

참조 명령에 전역 매개 변수를 추가하여 --verbose 로깅에 대한 자세한 내용을 알아봅니다. 자세한 정보 표시 출력은 특정 명령을 실행하는 데 다른 명령보다 오래 걸리는 이유를 이해하려고 할 때 유용합니다.

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

여기에 표시된 다음 콘솔 출력에는 간결하게 하기 위해 생략된 필드가 있지만 실행 시간에 대한 추가 정보를 확인합니다.

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

--debug global 매개 변수

매개 변수의 추가 세부 정보가 --verbose 충분하지 않고 전체 로그를 보려면 전역 매개 변수를 --debug 사용합니다. 또한 버그 보고서를 제출할 때 생성된 --debug 출력을 제공합니다.

az group create --name myrResourceGroup --location eastus --debug

여기에 표시된 다음 콘솔 출력에는 간결성을 위해 생략된 필드가 있습니다.


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 매개 변수

디버깅하는 동안 전역 매개 변수를 사용하여 --only-show-errors 참조 명령에서 반환된 경고를 제거합니다.

az interactive

출력 콘솔:

**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 매개 변수

전역 매개 변수를 --subscription 사용하여 명령에 대한 특정 구독을 설정할 수 있습니다. 다음 예제에서는 구독 ID를 사용하여 활성 구독을 변경합니다.

az account set --subscription "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

--output global 매개 변수

명령의 출력을 특정 형식으로 표시하려면 전역 매개 변수를 --output 지정합니다. 이 예제에서는 출력이 테이블로 표시됩니다.

참고 항목

출력에 허용되는 값은 json, jsonc, none, table, tsv, yaml 및 yamlc입니다. 기본 출력 값은 json입니다.

az vm list --resource-group myResourceGroup --output table

출력 콘솔:

Name    ResourceGroup    Location
------  ---------------  ----------
myVm    myResourceGroup  eastus

다양한 출력 형식에 대한 자세한 내용은 Azure CLI 명령에 대한 출력 형식을 참조 하세요.

--query global 매개 변수

출력 콘솔에서 필터링해야 하는 방대한 양의 정보를 표시할 수 있는 경우가 있습니다. 이렇게 하려면 전역 매개 변수를 --query 사용하여 명령 결과에 대해 JMESPath 쿼리를 실행합니다. JMESPath는 JSON에 대한 쿼리 언어로, Azure CLI 출력에서 데이터를 선택하고 수정하는 기능을 제공합니다.

이 예제에서는 다음을 추가하여 --query가상 머신에 연결할 권한이 있는 SSH 공개 키를 반환합니다.

 az vm show --resource-group myResourceGroup --name myVm --query "osProfile.linuxConfigurat
ion.ssh.publicKeys"

출력 콘솔:

[
  {
    "keyData": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC7WbiMEsB0iwdGPjeGXs3UWFtzbCkUwtIxzkIOpEtlqkLGa0XQdvwhzok6szq6Ycx/f4cfid/yrmBPtzmxdQnGeCy2FOcVIzp+SkjIUg/Ez2YyDcMb60u66QUmHPRyhipJ/PDZROt6O0092qfTkTjB+7hLRiZzV2raLjiQ95eV0AXUP+Gsvdo/7ytqWNIm3iQTWbQ/GwSg+p0v+kmZELIbrxo845dambSpgBL8g0wCUZaptru3ZHo9m0UWbFPASVJKauhfPCSVPQCaOCaAdB01Ih8QDVRCazT+jyV6GgTwUIXVQthVBbt56ibhuSUdf0cWF8IVncjH+WXexVAhQw0j",
    "path": "/home/yourName/.ssh/authorized_keys"
  }
]

명령 출력 쿼리에 대한 자세한 내용은 JMESPath 쿼리를 사용하여 Azure CLI 명령 출력을 쿼리하는 방법을 참조하세요.

참고 항목