az appconfig kv

App Configuration 저장된 키-값을 관리합니다.

명령

az appconfig kv delete

키-값을 삭제합니다.

az appconfig kv export

App Configuration 다른 위치로 구성을 내보냅니다.

az appconfig kv import

구성을 다른 위치에서 App Configuration 가져옵니다.

az appconfig kv list

키-값을 나열 합니다.

az appconfig kv lock

키-값을 잠가 쓰기 작업을 금지할 수 있습니다.

az appconfig kv restore

키-값을 복원합니다.

az appconfig kv set

키-값을 설정합니다.

az appconfig kv set-keyvault

keyvault 참조를 설정합니다.

az appconfig kv show

키-값의 모든 특성을 표시합니다.

az appconfig kv unlock

키-값의 잠금을 해제 하 여 쓰기 작업을 얻습니다.

az appconfig kv delete

키-값을 삭제합니다.

az appconfig kv delete --key
                       [--auth-mode {key, login}]
                       [--connection-string]
                       [--endpoint]
                       [--label]
                       [--name]
                       [--subscription]
                       [--yes]

예제

확인 없이 App Configuration 이름을 사용하여 키를 삭제합니다.

az appconfig kv delete -n MyAppConfiguration --key color --label MyLabel --yes

연결 문자열을 사용하여 키를 삭제합니다.

az appconfig kv delete --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx --key color --label MyLabel

'az login' 자격 증명을 사용하여 키를 삭제하고 엔드포인트를 App Configuration.

az appconfig kv delete --endpoint https://myappconfiguration.azconfig.io --key color --auth-mode login --yes

필수 매개 변수

--key

별 기호를 필터로 지원합니다. 예를 들어 * 모든 키와 * abc는 abc가 접두사로 있는 키를 의미합니다.

선택적 매개 변수

--auth-mode

이 매개 변수는 데이터 작업의 권한을 부여하는 방법을 나타내는 데 사용할 수 있습니다. 인증 모드가 "키"인 경우 연결 문자열 또는 저장소 이름을 제공하면 권한 부여를 위해 계정 액세스 키가 검색됩니다. 인증 모드가 "로그인"인 경우 저장소 엔드포인트 또는 저장소 이름을 입력하면 권한 부여에 "az login" 자격 증명이 사용됩니다. 를 사용하여 기본 인증 모드를 구성할 수 az configure --defaults appconfig_auth_mode=<auth_mode> 있습니다. 자세한 내용은 https://docs.microsoft.com/en-us/azure/azure-app-configuration/concept-enable-rbac를 참조하세요.

허용되는 값: key, login
기본값: key
--connection-string

액세스 키와 App Configuration 엔드포인트의 조합입니다. 'az appconfig credential list'를 사용하여 찾을 수 있습니다. 사용자는 또는 이름이 AZURE_APPCONFIG_CONNECTION_STRING 환경 변수를 사용하여 미리 지정할 수 az configure --defaults appconfig_connection_string=<connection_string> 있습니다.

--endpoint

인증 모드가 "로그인"인 경우 App Configuration 엔드포인트 URL을 제공합니다. "az appconfig show" 명령을 사용하여 엔드포인트를 검색할 수 있습니다. 를 사용하여 기본 엔드포인트를 구성할 수 az configure --defaults appconfig_endpoint=<endpoint> 있습니다.

--label

레이블을 지정하지 않으면 null 레이블이 있는 항목을 삭제합니다. 별 기호를 필터로 지원합니다. 예를 들어 * 모든 레이블을 * 의미하고 abc는 abc를 접두사로 가진 레이블을 의미합니다.

--name -n

App Configuration 이름입니다. 를 사용하여 기본 이름을 구성할 수 az configure --defaults app_configuration_store=<name> 있습니다.

--subscription

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

--yes -y

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

az appconfig kv export

App Configuration 다른 위치로 구성을 내보냅니다.

az appconfig kv export --destination {appconfig, appservice, file}
                       [--appservice-account]
                       [--auth-mode {key, login}]
                       [--connection-string]
                       [--dest-auth-mode {key, login}]
                       [--dest-connection-string]
                       [--dest-endpoint]
                       [--dest-label]
                       [--dest-name]
                       [--endpoint]
                       [--format {json, properties, yaml}]
                       [--key]
                       [--label]
                       [--name]
                       [--naming-convention {camel, hyphen, pascal, underscore}]
                       [--path]
                       [--prefix]
                       [--preserve-labels {false, true}]
                       [--resolve-keyvault {false, true}]
                       [--separator]
                       [--skip-features {false, true}]
                       [--skip-keyvault {false, true}]
                       [--subscription]
                       [--yes]

예제

레이블 테스트가 있는 모든 키 및 기능 플래그를 json 파일로 내보냅니다.

az appconfig kv export -n MyAppConfiguration --label test -d file --path D:/abc.json --format json

null 레이블이 있는 모든 키를 App Service 애플리케이션으로 내보냅니다.

az appconfig kv export -n MyAppConfiguration -d appservice --appservice-account MyAppService

기능 플래그를 제외한 레이블 테스트가 있는 모든 키를 json 파일로 내보냅니다.

az appconfig kv export -n MyAppConfiguration --label test -d file --path D:/abc.json --format json --skip-features

모든 레이블이 있는 모든 키 및 기능 플래그를 다른 App Configuration 내보냅니다.

az appconfig kv export -n MyAppConfiguration -d appconfig --dest-name AnotherAppConfiguration --key * --label * --preserve-labels

모든 레이블이 있는 모든 키 및 기능 플래그를 다른 App Configuration 내보내고 대상 레이블을 덮어쓰습니다.

az appconfig kv export -n MyAppConfiguration -d appconfig --dest-name AnotherAppConfiguration --key * --label * --dest-label ExportedKeys

'az login' 자격 증명을 사용하여 모든 키를 다른 App Configuration 내보냅니다.

az appconfig kv export -d appconfig --endpoint https://myappconfiguration.azconfig.io --auth-mode login --dest-endpoint https://anotherappconfiguration.azconfig.io --dest-auth-mode login --key * --label * --preserve-labels

필수 매개 변수

--destination -d

내보내기의 대상입니다. 기능 플래그를 appservice로 내보내는 것은 지원되지 않습니다.

허용되는 값: appconfig, appservice, file

선택적 매개 변수

--appservice-account

AppService의 ARM ID 또는 AppService 이름이 App Configuration 동일한 구독 및 리소스 그룹에 있다고 가정합니다. AppService 인수에 필요합니다.

--auth-mode

이 매개 변수는 데이터 작업의 권한을 부여하는 방법을 나타내는 데 사용할 수 있습니다. 인증 모드가 "키"인 경우 연결 문자열 또는 저장소 이름을 제공하면 권한 부여를 위해 계정 액세스 키가 검색됩니다. 인증 모드가 "로그인"인 경우 저장소 엔드포인트 또는 저장소 이름을 입력하면 권한 부여에 "az login" 자격 증명이 사용됩니다. 를 사용하여 기본 인증 모드를 구성할 수 az configure --defaults appconfig_auth_mode=<auth_mode> 있습니다. 자세한 내용은 https://docs.microsoft.com/en-us/azure/azure-app-configuration/concept-enable-rbac를 참조하세요.

허용되는 값: key, login
기본값: key
--connection-string

액세스 키와 App Configuration 엔드포인트의 조합입니다. 'az appconfig credential list'를 사용하여 찾을 수 있습니다. 사용자는 또는 이름이 AZURE_APPCONFIG_CONNECTION_STRING 환경 변수를 사용하여 미리 지정할 수 az configure --defaults appconfig_connection_string=<connection_string> 있습니다.

--dest-auth-mode

대상 App Configuration 연결하기 위한 인증 모드입니다. 자세한 내용은 "--auth-mode" 인수를 참조하세요.

허용되는 값: key, login
기본값: key
--dest-connection-string

액세스 키와 대상 저장소의 엔드포인트 조합입니다.

--dest-endpoint

--dest-auth-mode가 "login"인 경우 대상 App Configuration 엔드포인트 URL을 제공합니다.

--dest-label

내보낸 KV는 이 대상 레이블로 레이블이 지정됩니다. --dest-label 및 --preserve-labels를 둘 다 지정하지 않으면 는 null 레이블을 할당합니다.

--dest-name

대상 App Configuration 이름입니다.

--endpoint

인증 모드가 "로그인"인 경우 App Configuration 엔드포인트 URL을 제공합니다. "az appconfig show" 명령을 사용하여 엔드포인트를 검색할 수 있습니다. 를 사용하여 기본 엔드포인트를 구성할 수 az configure --defaults appconfig_endpoint=<endpoint> 있습니다.

--format

내보낼 파일 형식입니다. 파일 인수에 필요합니다. 현재 기능 플래그는 속성 형식에서 지원되지 않습니다.

허용되는 값: json, properties, yaml
--key

키가 지정되지 않은 경우 기본적으로 모든 키를 반환합니다. 별 기호를 필터로 지원합니다. 예를 들어 * abc는 abc를 접두사로 가진 키를 의미합니다. 기능 플래그에는 키 필터링을 적용할 수 없습니다. 기본적으로 지정된 레이블이 있는 모든 기능 플래그를 내보냅니다.

--label

이 레이블이 있는 키 및 기능 플래그만 내보냅니다. 레이블을 지정하지 않으면 기본적으로 null 레이블이 있는 키 및 기능 플래그를 내보냅니다. 내보내기 대상이 appconfig인 경우에만 별 기호를 필터로 지원합니다. 예를 들어 * 모든 레이블을 * 의미하고 abc는 abc를 접두사로 가진 레이블을 의미합니다. 파일 또는 appservice로 내보낼 때는 레이블 필터가 지원되지 않습니다.

--name -n

App Configuration 이름입니다. 를 사용하여 기본 이름을 구성할 수 az configure --defaults app_configuration_store=<name> 있습니다.

--naming-convention

파일의 "기능 관리" 섹션에 사용할 명명 규칙입니다. 예: pascal = FeatureManagement, camel = featureManagement, underscore = feature_management, 하이픈 = feature-management.

허용되는 값: camel, hyphen, pascal, underscore
기본값: pascal
--path

로컬 구성 파일 경로입니다. 파일 인수에 필요합니다.

--prefix

키에서 트리밍할 접두사입니다. 기능 플래그에 대한 접두사 는 무시됩니다.

--preserve-labels

원본 AppConfig에서 레이블을 유지하려면 플래그를 지정합니다. 이 인수는 --dest-label과 함께 지정하면 안 됩니다.

허용되는 값: false, true
--resolve-keyvault

키 자격 증명 모음 참조의 내용을 확인합니다.

허용되는 값: false, true
--separator

키-값 쌍을 json 또는 yaml 파일로 평면화하기 위한 구분 기호입니다. 계층 구조를 내보내는 데 필요합니다. 속성 파일 및 기능 플래그에 대해 구분 기호가 무시됩니다. 지원되는 값: '.', ',', ';', '-', '_', '__', '/', ':'.

--skip-features

모든 기능 플래그를 제외한 항목을 내보냅니다. 기본적으로 지정된 레이블이 있는 모든 기능을 파일 또는 appconfig로 내보냅니다. appservice에 적용할 수 없습니다.

허용되는 값: false, true
--skip-keyvault

모든 키 자격 증명 모음 참조를 제외한 항목을 내보냅니다. 기본적으로 지정된 레이블이 있는 모든 키 자격 증명 모음 참조를 내보냅니다.

허용되는 값: false, true
--subscription

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

--yes -y

미리 보기를 묻는 메시지를 표시하지 않습니다.

az appconfig kv import

구성을 다른 위치에서 App Configuration 가져옵니다.

az appconfig kv import --source {appconfig, appservice, file}
                       [--appservice-account]
                       [--auth-mode {key, login}]
                       [--connection-string]
                       [--content-type]
                       [--depth]
                       [--endpoint]
                       [--format {json, properties, yaml}]
                       [--label]
                       [--name]
                       [--path]
                       [--prefix]
                       [--preserve-labels {false, true}]
                       [--separator]
                       [--skip-features {false, true}]
                       [--src-auth-mode {key, login}]
                       [--src-connection-string]
                       [--src-endpoint]
                       [--src-key]
                       [--src-label]
                       [--src-name]
                       [--subscription]
                       [--yes]

예제

파일에서 모든 키와 기능 플래그를 가져오고 테스트 레이블을 적용합니다.

az appconfig kv import -n MyAppConfiguration --label test -s file --path D:/abc.json --format json

null 레이블이 있는 모든 키 및 기능 플래그를 가져오고 App Configuration 새 레이블을 적용합니다.

az appconfig kv import -n MyAppConfiguration -s appconfig --src-name AnotherAppConfiguration --label ImportedKeys

모든 키를 가져오고 App Service 애플리케이션에서 null 레이블을 적용합니다.

az appconfig kv import -n MyAppConfiguration -s appservice --appservice-account MyAppService

레이블 테스트를 통해 모든 키를 가져오고 App Configuration 기능 플래그를 제외한 test2 레이블을 적용합니다.

az appconfig kv import -n MyAppConfiguration -s appconfig --src-label test --label test2 --src-name AnotherAppConfiguration --skip-features

모든 레이블이 있는 모든 키 및 기능 플래그를 다른 App Configuration 가져옵니다.

az appconfig kv import -n MyAppConfiguration -s appconfig --src-name AnotherAppConfiguration --src-key * --src-label * --preserve-labels

JSON 파일에서 모든 키 및 기능 플래그를 가져오고 JSON 콘텐츠 형식을 적용합니다.

az appconfig kv import -n MyAppConfiguration -s file --path D:/abc.json --format json --separator . --content-type application/json

'az login' 자격 증명을 사용하여 다른 App Configuration 모든 키를 가져옵니다.

az appconfig kv import -s appconfig --endpoint https://myappconfiguration.azconfig.io --auth-mode login --src-endpoint https://anotherappconfiguration.azconfig.io --src-auth-mode login --src-key * --src-label * --preserve-labels

필수 매개 변수

--source -s

가져오기의 원본입니다. appservice에서 기능 플래그 가져오기는 지원되지 않습니다.

허용되는 값: appconfig, appservice, file

선택적 매개 변수

--appservice-account

AppService의 ARM ID 또는 AppService 이름이 App Configuration 동일한 구독 및 리소스 그룹에 있다고 가정합니다. AppService 인수에 필요합니다.

--auth-mode

이 매개 변수는 데이터 작업의 권한을 부여하는 방법을 나타내는 데 사용할 수 있습니다. 인증 모드가 "키" 인 경우 연결 문자열 또는 저장소 이름을 제공 하면 권한 부여를 위해 계정 액세스 키가 검색 됩니다. 인증 모드가 "로그인" 이면 저장소 끝점 또는 상점 이름을 제공 하 고 "az login" 자격 증명은 권한 부여에 사용 됩니다. 를 사용 하 여 기본 인증 모드를 구성할 수 있습니다 az configure --defaults appconfig_auth_mode=<auth_mode> . 자세한 내용은 https://docs.microsoft.com/en-us/azure/azure-app-configuration/concept-enable-rbac를 참조하세요.

허용되는 값: key, login
기본값: key
--connection-string

앱 구성의 선택 키와 끝점의 조합입니다. ' Az appconfig credential list '를 사용 하 여 찾을 수 있습니다. 사용자는 az configure --defaults appconfig_connection_string=<connection_string> AZURE_APPCONFIG_CONNECTION_STRING 이름으로 또는 환경 변수를 사용 하 여 미리 설정할 수 있습니다.

--content-type

가져온 모든 항목의 콘텐츠 형식입니다.

--depth

Json 또는 yaml 파일을 키-값 쌍으로 평면화 하는 깊이입니다. --Separator가 제공 된 경우 기본적으로 가장 깊은 수준으로 평면화 됩니다. 속성 파일 또는 기능 플래그에는 적용 되지 않습니다.

--endpoint

인증 모드가 "로그인" 이면 앱 구성의 끝점 URL을 제공 합니다. "Az appconfig show" 명령을 사용 하 여 끝점을 검색할 수 있습니다. 를 사용 하 여 기본 끝점을 구성할 수 있습니다 az configure --defaults appconfig_endpoint=<endpoint> .

--format

가져온 파일 형식입니다. 파일 인수에 필요 합니다. 현재 기능 플래그는 속성 형식에서 지원 되지 않습니다.

허용되는 값: json, properties, yaml
--label

가져온 KVs 및 기능 플래그는이 레이블로 할당 됩니다. 레이블이 지정 되지 않은 경우는 null 레이블을 할당 합니다.

--name -n

앱 구성의 이름입니다. 를 사용 하 여 기본 이름을 구성할 수 있습니다 az configure --defaults app_configuration_store=<name> .

--path

로컬 구성 파일 경로입니다. 파일 인수에 필요 합니다.

--prefix

이 접두사는 가져온 키 앞에 추가 됩니다. 기능 플래그의 경우 접두사는 무시 됩니다.

--preserve-labels

원본 AppConfig에서 레이블을 유지 하기 위한 플래그입니다. 이 인수는--레이블과 함께 지정 하면 안 됩니다.

허용되는 값: false, true
--separator

Json 또는 yaml 파일을 키-값 쌍으로 평면화 하는 구분 기호입니다. 구분 기호는 속성 파일 및 기능 플래그에 대해 무시 됩니다. 지원 되는 값: '. ', ', ', '; ', '-', ' _ ', ' __ ', '/', ': '.

--skip-features

키 값만 가져오고 모든 기능 플래그를 제외 합니다. 기본적으로 모든 기능 플래그는 파일 또는 appconfig에서 가져옵니다. Appservice에는 적용 되지 않습니다.

허용되는 값: false, true
--src-auth-mode

원본 앱 구성에 연결 하기 위한 인증 모드입니다. 자세한 내용은 "--auth" 인수를 참조 하세요.

허용되는 값: key, login
기본값: key
--src-connection-string

소스 저장소의 선택 키와 끝점의 조합입니다.

--src-endpoint

--Src-인증 모드가 "로그인" 이면 소스 앱 구성의 끝점 URL을 제공 합니다.

--src-key

키를 지정 하지 않으면 기본적으로 모든 키를 가져옵니다. 별모양 기호를 지원 합니다. 예를 들어 abc는 * 접두사가 접두사로 사용 되는 키를 의미 합니다. 기능 플래그에는 키 필터링이 적용 되지 않습니다. 기본적으로 지정 된 레이블이 있는 모든 기능 플래그를 가져옵니다.

--src-label

원본 AppConfig에서이 레이블이 있는 키만 가져옵니다. 값을 지정 하지 않으면 기본적으로 null 레이블을 사용 하 여 키를 가져옵니다. Star 기호를 지원 합니다. 예를 들어 * 모든 레이블을 의미 하는 abc는 * 접두사가 접두사로 포함 된 레이블을 의미 합니다.

--src-name

원본 앱 구성의 이름입니다.

--subscription

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

--yes -y

미리 보기에 대 한 메시지를 표시 하지 않습니다.

az appconfig kv list

키-값을 나열 합니다.

az appconfig kv list [--all]
                     [--auth-mode {key, login}]
                     [--connection-string]
                     [--datetime]
                     [--endpoint]
                     [--fields {content_type, etag, key, label, last_modified, locked, tags, value}]
                     [--key]
                     [--label]
                     [--name]
                     [--query-examples]
                     [--resolve-keyvault {false, true}]
                     [--subscription]
                     [--top]

예제

Null 레이블이 있는 모든 키 값을 나열 합니다.

az appconfig kv list -n MyAppConfiguration --label \0

V1으로 시작 하는 모든 레이블의 특정 키를 나열 합니다. 연결 문자열을 사용 합니다.

az appconfig kv list --key color --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx --label v1.*

모든 키를 레이블과 쿼리 전용 키, 값 및 태그만 나열 합니다.

az appconfig kv list --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx --fields key value tags --datetime "2019-05-01T11:24:12Z"

키 접두사 ' KVRef_ ' 인 key vault 참조의 콘텐츠를 나열 하 고 키와 값만 선택 합니다.

az appconfig kv list -n MyAppConfiguration --key "KVRef_*" --resolve-keyvault --query "[*].{key:key, value:value}"

여러 레이블이 있는 키-값을 나열 합니다.

az appconfig kv list --label test,prod,\0 -n MyAppConfiguration

' Az 로그인 ' credentials 자격 증명을 사용 하 여 모든 레이블로 모든 키 값을 나열 합니다.

az appconfig kv list --endpoint https://myappconfiguration.azconfig.io --auth-mode login

선택적 매개 변수

--all

모든 항목을 나열 합니다.

--auth-mode

이 매개 변수를 사용 하 여 데이터 작업의 권한을 부여 하는 방법을 나타낼 수 있습니다. 인증 모드가 "키" 인 경우 연결 문자열 또는 저장소 이름을 제공 하면 권한 부여를 위해 계정 액세스 키가 검색 됩니다. 인증 모드가 "로그인" 이면 저장소 끝점 또는 상점 이름을 제공 하 고 "az login" 자격 증명은 권한 부여에 사용 됩니다. 를 사용 하 여 기본 인증 모드를 구성할 수 있습니다 az configure --defaults appconfig_auth_mode=<auth_mode> . 자세한 내용은 https://docs.microsoft.com/en-us/azure/azure-app-configuration/concept-enable-rbac를 참조하세요.

허용되는 값: key, login
기본값: key
--connection-string

앱 구성의 선택 키와 끝점의 조합입니다. ' Az appconfig credential list '를 사용 하 여 찾을 수 있습니다. 사용자는 az configure --defaults appconfig_connection_string=<connection_string> AZURE_APPCONFIG_CONNECTION_STRING 이름으로 또는 환경 변수를 사용 하 여 미리 설정할 수 있습니다.

--datetime

형식: "YYYY-MM-DD-Yyyy-mm-ddthh: MM: ssZ". 표준 시간대가 지정 되지 않은 경우 기본적으로 UTC를 사용 합니다.

--endpoint

인증 모드가 "로그인" 이면 앱 구성의 끝점 URL을 제공 합니다. "Az appconfig show" 명령을 사용 하 여 끝점을 검색할 수 있습니다. 를 사용 하 여 기본 끝점을 구성할 수 있습니다 az configure --defaults appconfig_endpoint=<endpoint> .

--fields

공백으로 구분 된 사용자 지정 출력 필드입니다.

허용되는 값: content_type, etag, key, label, last_modified, locked, tags, value
--key

키를 지정 하지 않으면 기본적으로 모든 키를 반환 합니다. 별모양 기호를 지원 합니다. 예를 들어 abc는 * 접두사가 접두사로 사용 되는 키를 의미 합니다.

--label

레이블이 지정 되지 않은 경우 모든 레이블을 나열 합니다. 별모양 기호를 지원 합니다. 예를 들어 abc는 * 접두사가 abc 인 레이블을 의미 합니다. Null 레이블에는 ' 0 '을 사용 합니다.

--name -n

앱 구성의 이름입니다. 를 사용 하 여 기본 이름을 구성할 수 있습니다 az configure --defaults app_configuration_store=<name> .

--query-examples

JMESPath 문자열을 권장 합니다. 쿼리 중 하나를 복사 하 여 결과를 볼 수 있도록 큰따옴표 내에서--query 매개 변수 뒤에 붙여 넣을 수 있습니다. 이러한 주요 단어를 기준으로 제안을 제공할 수 있도록 하나 이상의 위치 키워드를 추가할 수 있습니다.

--resolve-keyvault

Key vault 참조의 콘텐츠를 확인 합니다. 이 인수는--fields와 함께 지정 하면 안 됩니다. 대신 사용자 지정 쿼리를 사용 하 여 쿼리를 사용 합니다.

허용되는 값: false, true
--subscription

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

--top -t

반환할 최대 항목 수입니다. 양의 정수여야 합니다. 기본값은 100입니다.

az appconfig kv lock

키-값을 잠가 쓰기 작업을 금지할 수 있습니다.

az appconfig kv lock --key
                     [--auth-mode {key, login}]
                     [--connection-string]
                     [--endpoint]
                     [--label]
                     [--name]
                     [--subscription]
                     [--yes]

예제

앱 구성 이름을 사용 하 여 키-값을 잠급니다.

az appconfig kv lock -n MyAppConfiguration --key color --label test

연결 문자열을 사용 하 여 키-값 잠금을 강제 합니다.

az appconfig kv lock --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx --key color --label test --yes

필수 매개 변수

--key

잠글 키입니다.

선택적 매개 변수

--auth-mode

이 매개 변수를 사용 하 여 데이터 작업의 권한을 부여 하는 방법을 나타낼 수 있습니다. 인증 모드가 "키" 인 경우 연결 문자열 또는 저장소 이름을 제공 하면 권한 부여를 위해 계정 액세스 키가 검색 됩니다. 인증 모드가 "로그인" 이면 저장소 끝점 또는 상점 이름을 제공 하 고 "az login" 자격 증명은 권한 부여에 사용 됩니다. 를 사용 하 여 기본 인증 모드를 구성할 수 있습니다 az configure --defaults appconfig_auth_mode=<auth_mode> . 자세한 내용은 https://docs.microsoft.com/en-us/azure/azure-app-configuration/concept-enable-rbac를 참조하세요.

허용되는 값: key, login
기본값: key
--connection-string

앱 구성의 선택 키와 끝점의 조합입니다. ' Az appconfig credential list '를 사용 하 여 찾을 수 있습니다. 사용자는 또는 이름이 AZURE_APPCONFIG_CONNECTION_STRING 환경 변수를 사용하여 미리 지정할 수 az configure --defaults appconfig_connection_string=<connection_string> 있습니다.

--endpoint

인증 모드가 "로그인"인 경우 App Configuration 엔드포인트 URL을 제공합니다. "az appconfig show" 명령을 사용하여 엔드포인트를 검색할 수 있습니다. 를 사용하여 기본 엔드포인트를 구성할 수 az configure --defaults appconfig_endpoint=<endpoint> 있습니다.

--label

레이블을 지정하지 않으면 null 레이블이 있는 항목을 잠급합니다. 필터링이 지원되지 않는 경우

--name -n

App Configuration 이름입니다. 를 사용하여 기본 이름을 구성할 수 az configure --defaults app_configuration_store=<name> 있습니다.

--subscription

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

--yes -y

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

az appconfig kv restore

키-값을 복원합니다.

az appconfig kv restore --datetime
                        [--auth-mode {key, login}]
                        [--connection-string]
                        [--endpoint]
                        [--key]
                        [--label]
                        [--name]
                        [--subscription]
                        [--yes]

예제

모든 키 값을 특정 시점으로 복원합니다.

az appconfig kv restore -n MyAppConfiguration --datetime "2019-05-01T11:24:12Z"

v1로 시작하는 레이블에 대한 특정 키를 복원합니다. 특정 지정 시간에 연결 문자열을 사용하는 경우

az appconfig kv restore --key color --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx --label v1.* --datetime "2019-05-01T11:24:12Z"

필수 매개 변수

--datetime

형식: "YYYY-MM-DDThh:mm:ssZ". 표준 시간대를 지정하지 않으면 기본적으로 UTC를 사용합니다.

선택적 매개 변수

--auth-mode

이 매개 변수는 데이터 작업의 권한을 부여하는 방법을 나타내는 데 사용할 수 있습니다. 인증 모드가 "키"인 경우 연결 문자열 또는 저장소 이름을 제공하면 권한 부여를 위해 계정 액세스 키가 검색됩니다. 인증 모드가 "로그인"인 경우 저장소 엔드포인트 또는 저장소 이름을 입력하면 권한 부여에 "az login" 자격 증명이 사용됩니다. 를 사용하여 기본 인증 모드를 구성할 수 az configure --defaults appconfig_auth_mode=<auth_mode> 있습니다. 자세한 내용은 https://docs.microsoft.com/en-us/azure/azure-app-configuration/concept-enable-rbac를 참조하세요.

허용되는 값: key, login
기본값: key
--connection-string

액세스 키와 App Configuration 엔드포인트의 조합입니다. 'az appconfig credential list'를 사용하여 찾을 수 있습니다. 사용자는 또는 이름이 AZURE_APPCONFIG_CONNECTION_STRING 환경 변수를 사용하여 미리 지정할 수 az configure --defaults appconfig_connection_string=<connection_string> 있습니다.

--endpoint

인증 모드가 "로그인"인 경우 App Configuration 엔드포인트 URL을 제공합니다. "az appconfig show" 명령을 사용하여 엔드포인트를 검색할 수 있습니다. 를 사용하여 기본 엔드포인트를 구성할 수 az configure --defaults appconfig_endpoint=<endpoint> 있습니다.

--key

키가 지정되지 않은 경우 기본적으로 모든 키를 복원합니다. 별 기호를 필터로 지원합니다. 예를 들어 * abc는 abc를 접두사로 가진 키를 의미합니다.

--label

레이블을 지정하지 않으면 모든 레이블과 함께 모든 키-값 쌍을 복원합니다. 별 기호를 필터로 지원합니다. 예를 들어 * abc는 abc가 접두사로 있는 레이블을 의미합니다. null 레이블에는 '0'을 사용합니다.

--name -n

App Configuration 이름입니다. 를 사용하여 기본 이름을 구성할 수 az configure --defaults app_configuration_store=<name> 있습니다.

--subscription

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

--yes -y

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

az appconfig kv set

키-값을 설정합니다.

az appconfig kv set --key
                    [--auth-mode {key, login}]
                    [--connection-string]
                    [--content-type]
                    [--endpoint]
                    [--label]
                    [--name]
                    [--subscription]
                    [--tags]
                    [--value]
                    [--yes]

예제

MyLabel 레이블을 가진 키 값을 설정합니다.

az appconfig kv set -n MyAppConfiguration --key color --label MyLabel --value red

연결 문자열을 사용하여 null 레이블이 있는 키를 설정합니다.

az appconfig kv set --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx --key color --value red --tags key1=value1 key2=value2

문자열 값 및 JSON 콘텐츠 형식으로 키를 설정합니다.

az appconfig kv set -n MyAppConfiguration --key color --value \"red\" --content-type application/json

목록 값 및 JSON 콘텐츠 형식으로 키를 설정합니다.

az appconfig kv set -n MyAppConfiguration --key options --value [1,2,3] --content-type application/activity+json;charset=utf-8

null 값 및 JSON 콘텐츠 형식으로 키를 설정합니다.

az appconfig kv set -n MyAppConfiguration --key foo --value null --content-type application/json

'az login' 자격 증명을 사용하여 키 값을 설정합니다.

az appconfig kv set --endpoint https://myappconfiguration.azconfig.io --key color --value red --auth-mode login

필수 매개 변수

--key

설정할 키입니다. 키는 '.' 또는 '..'이거나 '%' 문자를 포함할 수 없습니다.

선택적 매개 변수

--auth-mode

이 매개 변수는 데이터 작업의 권한을 부여하는 방법을 나타내는 데 사용할 수 있습니다. 인증 모드가 "키"인 경우 연결 문자열 또는 저장소 이름을 제공하면 권한 부여를 위해 계정 액세스 키가 검색됩니다. 인증 모드가 "로그인"인 경우 저장소 엔드포인트 또는 저장소 이름을 입력하면 권한 부여에 "az login" 자격 증명이 사용됩니다. 를 사용하여 기본 인증 모드를 구성할 수 az configure --defaults appconfig_auth_mode=<auth_mode> 있습니다. 자세한 내용은 https://docs.microsoft.com/en-us/azure/azure-app-configuration/concept-enable-rbac를 참조하세요.

허용되는 값: key, login
기본값: key
--connection-string

액세스 키와 App Configuration 엔드포인트의 조합입니다. 'az appconfig credential list'를 사용하여 찾을 수 있습니다. 사용자는 또는 이름이 AZURE_APPCONFIG_CONNECTION_STRING 환경 변수를 사용하여 미리 지정할 수 az configure --defaults appconfig_connection_string=<connection_string> 있습니다.

--content-type

설정할 키 값의 콘텐츠 형식입니다.

--endpoint

인증 모드가 "로그인"인 경우 App Configuration 엔드포인트 URL을 제공합니다. "az appconfig show" 명령을 사용하여 엔드포인트를 검색할 수 있습니다. 를 사용하여 기본 엔드포인트를 구성할 수 az configure --defaults appconfig_endpoint=<endpoint> 있습니다.

--label

레이블을 지정하지 않으면 기본적으로 null 레이블로 키를 설정합니다.

--name -n

App Configuration 이름입니다. 를 사용하여 기본 이름을 구성할 수 az configure --defaults app_configuration_store=<name> 있습니다.

--subscription

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

--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

--value

설정할 키 값입니다.

--yes -y

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

az appconfig kv set-keyvault

keyvault 참조를 설정합니다.

az appconfig kv set-keyvault --key
                             --secret-identifier
                             [--auth-mode {key, login}]
                             [--connection-string]
                             [--endpoint]
                             [--label]
                             [--name]
                             [--subscription]
                             [--tags]
                             [--yes]

예제

MyLabel 레이블을 가진 keyvault 참조를 설정합니다.

az appconfig kv set-keyvault -n MyAppConfiguration --key HostSecret --label MyLabel --secret-identifier https://contoso.vault.azure.net/Secrets/DummySecret/Dummyversion

연결 문자열을 사용하여 null 레이블 및 여러 태그를 사용하여 keyvault 참조를 설정합니다.

az appconfig kv set-keyvault --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx --key HostSecret --secret-identifier https://contoso.vault.azure.net/Secrets/DummySecret --tags tag1=value1 tag2=value2

필수 매개 변수

--key

설정할 키입니다. 키는 '.' 또는 '..'이거나 '%' 문자를 포함할 수 없습니다.

--secret-identifier

Key Vault 개체의 ID입니다. 'az keyvault {collection} show' 명령을 사용하여 찾을 수 있습니다. 여기서 collection은 키, 비밀 또는 인증서입니다. 최신 버전의 비밀에 대한 참조를 설정하려면 비밀 식별자에서 버전 정보를 제거합니다.

선택적 매개 변수

--auth-mode

이 매개 변수는 데이터 작업의 권한을 부여하는 방법을 나타내는 데 사용할 수 있습니다. 인증 모드가 "키"인 경우 연결 문자열 또는 저장소 이름을 제공하면 권한 부여를 위해 계정 액세스 키가 검색됩니다. 인증 모드가 "로그인"인 경우 저장소 엔드포인트 또는 저장소 이름을 입력하면 권한 부여에 "az login" 자격 증명이 사용됩니다. 를 사용하여 기본 인증 모드를 구성할 수 az configure --defaults appconfig_auth_mode=<auth_mode> 있습니다. 자세한 내용은 https://docs.microsoft.com/en-us/azure/azure-app-configuration/concept-enable-rbac를 참조하세요.

허용되는 값: key, login
기본값: key
--connection-string

액세스 키와 App Configuration 엔드포인트의 조합입니다. 'az appconfig credential list'를 사용하여 찾을 수 있습니다. 사용자는 또는 이름이 AZURE_APPCONFIG_CONNECTION_STRING 환경 변수를 사용하여 미리 지정할 수 az configure --defaults appconfig_connection_string=<connection_string> 있습니다.

--endpoint

인증 모드가 "로그인"인 경우 App Configuration 엔드포인트 URL을 제공합니다. "az appconfig show" 명령을 사용하여 엔드포인트를 검색할 수 있습니다. 를 사용하여 기본 엔드포인트를 구성할 수 az configure --defaults appconfig_endpoint=<endpoint> 있습니다.

--label

레이블을 지정하지 않으면 기본적으로 null 레이블로 키를 설정합니다.

--name -n

App Configuration 이름입니다. 를 사용하여 기본 이름을 구성할 수 az configure --defaults app_configuration_store=<name> 있습니다.

--subscription

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

--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

--yes -y

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

az appconfig kv show

키-값의 모든 특성을 표시합니다.

az appconfig kv show --key
                     [--auth-mode {key, login}]
                     [--connection-string]
                     [--datetime]
                     [--endpoint]
                     [--label]
                     [--name]
                     [--query-examples]
                     [--subscription]

예제

특정 레이블 및 datetime과 함께 App Configuration 이름을 사용하여 키-값 표시

az appconfig kv show -n MyAppConfiguration --key color --label MyLabel --datetime "2019-05-01T11:24:12Z"

레이블이 있는 연결 문자열을 사용하여 키-값 표시

az appconfig kv show --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx --key color --label MyLabel

'az login' 자격 증명을 사용하여 키 값을 표시합니다.

az appconfig kv show --key color --auth-mode login --endpoint https://myappconfiguration.azconfig.io

필수 매개 변수

--key

표시할 키입니다.

선택적 매개 변수

--auth-mode

이 매개 변수는 데이터 작업의 권한을 부여하는 방법을 나타내는 데 사용할 수 있습니다. 인증 모드가 "키"인 경우 연결 문자열 또는 저장소 이름을 제공하면 권한 부여를 위해 계정 액세스 키가 검색됩니다. 인증 모드가 "로그인" 이면 저장소 끝점 또는 상점 이름을 제공 하 고 "az login" 자격 증명은 권한 부여에 사용 됩니다. 를 사용 하 여 기본 인증 모드를 구성할 수 있습니다 az configure --defaults appconfig_auth_mode=<auth_mode> . 자세한 내용은 https://docs.microsoft.com/en-us/azure/azure-app-configuration/concept-enable-rbac를 참조하세요.

허용되는 값: key, login
기본값: key
--connection-string

앱 구성의 선택 키와 끝점의 조합입니다. ' Az appconfig credential list '를 사용 하 여 찾을 수 있습니다. 사용자는 az configure --defaults appconfig_connection_string=<connection_string> AZURE_APPCONFIG_CONNECTION_STRING 이름으로 또는 환경 변수를 사용 하 여 미리 설정할 수 있습니다.

--datetime

형식: "YYYY-MM-DD-Yyyy-mm-ddthh: MM: ssZ". 표준 시간대가 지정 되지 않은 경우 기본적으로 UTC를 사용 합니다.

--endpoint

인증 모드가 "로그인" 이면 앱 구성의 끝점 URL을 제공 합니다. "Az appconfig show" 명령을 사용 하 여 끝점을 검색할 수 있습니다. 를 사용 하 여 기본 끝점을 구성할 수 있습니다 az configure --defaults appconfig_endpoint=<endpoint> .

--label

레이블이 지정 되지 않은 경우 null 레이블이 있는 항목을 표시 합니다. 필터링이 지원되지 않는 경우

--name -n

앱 구성의 이름입니다. 를 사용 하 여 기본 이름을 구성할 수 있습니다 az configure --defaults app_configuration_store=<name> .

--query-examples

JMESPath 문자열을 권장 합니다. 쿼리 중 하나를 복사 하 여 결과를 볼 수 있도록 큰따옴표 내에서--query 매개 변수 뒤에 붙여 넣을 수 있습니다. 이러한 주요 단어를 기준으로 제안을 제공할 수 있도록 하나 이상의 위치 키워드를 추가할 수 있습니다.

--subscription

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

az appconfig kv unlock

키-값의 잠금을 해제 하 여 쓰기 작업을 얻습니다.

az appconfig kv unlock --key
                       [--auth-mode {key, login}]
                       [--connection-string]
                       [--endpoint]
                       [--label]
                       [--name]
                       [--subscription]
                       [--yes]

예제

앱 구성 이름을 사용 하 여 키-값의 잠금을 해제 합니다.

az appconfig kv unlock -n MyAppConfiguration --key color --label test

연결 문자열을 사용 하 여 키-값의 잠금을 강제로 해제 합니다.

az appconfig kv unlock --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx --key color --label test --yes

필수 매개 변수

--key

잠금을 해제할 키입니다.

선택적 매개 변수

--auth-mode

이 매개 변수를 사용 하 여 데이터 작업의 권한을 부여 하는 방법을 나타낼 수 있습니다. 인증 모드가 "키" 인 경우 연결 문자열 또는 저장소 이름을 제공 하면 권한 부여를 위해 계정 액세스 키가 검색 됩니다. 인증 모드가 "로그인" 이면 저장소 끝점 또는 상점 이름을 제공 하 고 "az login" 자격 증명은 권한 부여에 사용 됩니다. 를 사용 하 여 기본 인증 모드를 구성할 수 있습니다 az configure --defaults appconfig_auth_mode=<auth_mode> . 자세한 내용은 https://docs.microsoft.com/en-us/azure/azure-app-configuration/concept-enable-rbac를 참조하세요.

허용되는 값: key, login
기본값: key
--connection-string

앱 구성의 선택 키와 끝점의 조합입니다. ' Az appconfig credential list '를 사용 하 여 찾을 수 있습니다. 사용자는 az configure --defaults appconfig_connection_string=<connection_string> AZURE_APPCONFIG_CONNECTION_STRING 이름으로 또는 환경 변수를 사용 하 여 미리 설정할 수 있습니다.

--endpoint

인증 모드가 "로그인" 이면 앱 구성의 끝점 URL을 제공 합니다. "Az appconfig show" 명령을 사용 하 여 끝점을 검색할 수 있습니다. 를 사용 하 여 기본 끝점을 구성할 수 있습니다 az configure --defaults appconfig_endpoint=<endpoint> .

--label

레이블이 지정 되지 않은 경우 null 레이블이 있는 항목의 잠금을 해제 합니다. 필터링이 지원되지 않는 경우

--name -n

앱 구성의 이름입니다. 를 사용 하 여 기본 이름을 구성할 수 있습니다 az configure --defaults app_configuration_store=<name> .

--subscription

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

--yes -y

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