다음을 통해 공유

az extension

  • 참조

CLI 확장을 관리하고 업데이트합니다.

명령

Name Description 형식 상태
az extension add

확장을 추가합니다.

 핵심 GA
az extension list

설치된 확장을 나열합니다.

 핵심 GA
az extension list-available

공개적으로 사용 가능한 확장을 나열합니다.

 핵심 GA
az extension list-versions

확장에 사용 가능한 버전을 나열합니다.

 핵심 GA
az extension remove

확장을 제거합니다.

 핵심 GA
az extension show

확장을 표시합니다.

 핵심 GA
az extension update

확장을 업데이트합니다.

 핵심 GA

az extension add

편집

확장을 추가합니다.

자동으로 확장을 설치하는 방법을 알아보려면 다음을 방문하세요 https://aka.ms/AzExtDynamicInstall.

az extension add [--allow-preview {false, true}]
                 [--name]
                 [--pip-extra-index-urls]
                 [--pip-proxy]
                 [--source]
                 [--system]
                 [--upgrade]
                 [--version]
                 [--yes]

예제

이름별 확장 추가

az extension add --name anextension

URL에서 확장 추가

az extension add --source https://contoso.com/anextension-0.0.1-py2.py3-none-any.whl

로컬 디스크에서 확장 추가

az extension add --source ~/anextension-0.0.1-py2.py3-none-any.whl

로컬 디스크에서 확장 추가 및 종속성에 pip 프록시 사용

az extension add --source ~/anextension-0.0.1-py2.py3-none-any.whl --pip-proxy https://user:pass@proxy.server:8080

시스템 디렉터리에 확장 추가

az extension add --name anextension --system

특정 버전의 확장 추가

az extension add --name anextension --version 1.0.0

이미 설치된 경우 확장 업그레이드

az extension add --upgrade --name anextension

선택적 매개 변수

--allow-preview
사용되지 않음

'--allow-preview'의 기본값은 다음 호환성이 손상되는 변경 릴리스(2.67.0)에서 'true'에서 'false'로 변경됩니다.

확장 설치를 위한 미리 보기 패키지(있는 경우)를 포함합니다.

허용되는 값: false, true
--name -n

확장의 이름입니다.

--pip-extra-index-urls

사용할 패키지 인덱스의 추가 URL을 공백으로 구분한 목록입니다. PEP 503(간단한 리포지토리 API) 규격 리포지토리 또는 동일한 형식으로 명시된 로컬 디렉터리를 가리켜야 합니다.

--pip-proxy

[user:passwd@]proxy.server:port 형식의 확장 종속성에 사용할 pip의 프록시입니다.

--source -s

확장에 대한 파일 경로 또는 URL입니다.

--system

확장에 시스템 디렉터리를 사용합니다.

기본 경로는 python 환경 lib 경로를 실행하는 CLI 아래의 azure-cli-extensions 폴더이며, 환경 변수 AZURE_EXTENSION_SYS_DIR 구성 가능합니다. Windows에서 올바른 권한으로 실행하려면 관리자 권한으로 셸을 열어야 할 수 있습니다.

--upgrade

이미 설치된 경우 확장을 업데이트하고, 그렇지 않으면 확장을 설치하기만 하면됩니다.

--version

확장의 특정 버전입니다.

Default value: latest
--yes -y

확인을 묻는 메시지를 표시하지 마세요.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az extension list

편집

설치된 확장을 나열합니다.

az extension list
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az extension list-available

편집

공개적으로 사용 가능한 확장을 나열합니다.

az extension list-available [--show-details]

예제

공개적으로 사용 가능한 모든 확장 나열

az extension list-available

특정 확장에 대한 세부 정보 나열

az extension list-available --show-details --query anextension

선택적 매개 변수

--show-details -d

확장 인덱스의 원시 데이터를 표시합니다.

Default value: False
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az extension list-versions

편집

확장에 사용 가능한 버전을 나열합니다.

az extension list-versions --name

예제

확장에 사용 가능한 버전 나열

az extension list-versions --name anextension

필수 매개 변수

--name -n

확장의 이름입니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az extension remove

편집

확장을 제거합니다.

az extension remove --name

예제

확장을 제거합니다. (자동 생성됨)

az extension remove --name MyExtension

필수 매개 변수

--name -n

확장의 이름입니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az extension show

편집

확장을 표시합니다.

az extension show --name

예제

확장을 표시합니다. (자동 생성됨)

az extension show --name MyExtension

필수 매개 변수

--name -n

확장의 이름입니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az extension update

편집

확장을 업데이트합니다.

az extension update --name
                    [--allow-preview {false, true}]
                    [--pip-extra-index-urls]
                    [--pip-proxy]

예제

이름으로 확장 업데이트

az extension update --name anextension

이름으로 확장을 업데이트하고 종속성에 pip 프록시 사용

az extension update --name anextension --pip-proxy https://user:pass@proxy.server:8080

필수 매개 변수

--name -n

확장의 이름입니다.

선택적 매개 변수

--allow-preview
사용되지 않음

'--allow-preview'의 기본값은 다음 호환성이 손상되는 변경 릴리스(2.67.0)에서 'true'에서 'false'로 변경됩니다.

확장 설치를 위한 미리 보기 패키지(있는 경우)를 포함합니다.

허용되는 값: false, true
--pip-extra-index-urls

사용할 패키지 인덱스의 추가 URL을 공백으로 구분한 목록입니다. PEP 503(간단한 리포지토리 API) 규격 리포지토리 또는 동일한 형식으로 명시된 로컬 디렉터리를 가리켜야 합니다.

--pip-proxy

[user:passwd@]proxy.server:port 형식의 확장 종속성에 사용할 pip의 프록시입니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.