다음을 통해 공유

az extension

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

명령

Name Description 형식 상태
az extension add

확장을 추가합니다.

 Core GA
az extension list

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

 Core GA
az extension list-available

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

 Core GA
az extension list-versions

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

 Core GA
az extension remove

확장을 제거합니다.

 Core GA
az extension show

확장을 표시합니다.

 Core GA
az extension update

확장을 업데이트합니다.

 Core 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

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

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

확장의 이름입니다.

--pip-extra-index-urls

사용할 패키지 인덱스의 추가 URL에 대한 공백으로 구분된 목록입니다. 이는 PEP 503(간단한 리포지토리 API) 또는 동일한 형식으로 배치된 로컬 디렉터리를 준수하는 리포지토리를 가리킵니다.

속성 값
매개 변수 그룹: Experimental Pip Arguments
--pip-proxy

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

속성 값
매개 변수 그룹: Experimental Pip Arguments
--source -s

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

--system

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

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

--upgrade

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

--version

확장의 특정 버전입니다.

속성 값
Default value: latest
--yes -y

확인 메시지를 표시하지 않습니다.

전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

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

--only-show-errors

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

속성 값
Default value: False
--output -o

출력 형식

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

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False

az extension list

편집

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

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

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

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

--only-show-errors

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

속성 값
Default value: False
--output -o

출력 형식

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

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False

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

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

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

--only-show-errors

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

속성 값
Default value: False
--output -o

출력 형식

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

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False

az extension list-versions

편집

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

az extension list-versions --name

예제

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

az extension list-versions --name anextension

필수 매개 변수

--name -n

확장의 이름입니다.

전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

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

--only-show-errors

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

속성 값
Default value: False
--output -o

출력 형식

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

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False

az extension remove

편집

확장을 제거합니다.

az extension remove --name

예제

확장을 제거합니다. (autogenerated)

az extension remove --name MyExtension

필수 매개 변수

--name -n

확장의 이름입니다.

전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

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

--only-show-errors

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

속성 값
Default value: False
--output -o

출력 형식

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

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False

az extension show

편집

확장을 표시합니다.

az extension show --name

예제

확장을 표시합니다. (autogenerated)

az extension show --name MyExtension

필수 매개 변수

--name -n

확장의 이름입니다.

전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

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

--only-show-errors

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

속성 값
Default value: False
--output -o

출력 형식

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

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False

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

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

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

사용할 패키지 인덱스의 추가 URL에 대한 공백으로 구분된 목록입니다. 이는 PEP 503(간단한 리포지토리 API) 또는 동일한 형식으로 배치된 로컬 디렉터리를 준수하는 리포지토리를 가리킵니다.

속성 값
매개 변수 그룹: Experimental Pip Arguments
--pip-proxy

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

속성 값
매개 변수 그룹: Experimental Pip Arguments
전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

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

--only-show-errors

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

속성 값
Default value: False
--output -o

출력 형식

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

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False