az appconfig

管理應用程式組態。

命令

名稱	Description	類型	狀態
az appconfig create	建立應用程式組態。	Core	GA
az appconfig credential	管理應用程式組態存放區的認證。	Core	GA
az appconfig credential list	列出應用程式組態存放區的存取金鑰。	Core	GA
az appconfig credential regenerate	重新產生應用程式組態存放區的存取金鑰。	Core	GA
az appconfig delete	刪除應用程式組態存放區。	Core	GA
az appconfig feature	管理儲存在應用程式組態存放區中的功能旗標。	Core	GA
az appconfig feature delete	刪除功能旗標。	Core	GA
az appconfig feature disable	停用功能旗標以將其關閉以供使用。	Core	GA
az appconfig feature enable	啟用功能旗標以開啟它以供使用。	Core	GA
az appconfig feature filter	管理與應用程式組態存放區中儲存之功能旗標相關聯的篩選。	Core	GA
az appconfig feature filter add	將篩選新增至功能旗標。	Core	GA
az appconfig feature filter delete	從功能旗標刪除篩選。	Core	GA
az appconfig feature filter list	列出功能旗標的所有篩選。	Core	GA
az appconfig feature filter show	顯示功能旗標的篩選。	Core	GA
az appconfig feature filter update	更新功能旗標的篩選。	Core	GA
az appconfig feature list	列出功能旗標。	Core	GA
az appconfig feature lock	鎖定功能旗標以禁止寫入作業。	Core	GA
az appconfig feature set	設定功能旗標。	Core	GA
az appconfig feature show	顯示功能旗標的的所有屬性。	Core	GA
az appconfig feature unlock	解除鎖定功能以取得寫入作業。	Core	GA
az appconfig identity	應用程式組態存放區的受控識別。	Core	GA
az appconfig identity assign	更新應用程式組態存放區的受控識別。	Core	GA
az appconfig identity remove	拿掉應用程式組態存放區的受控識別。	Core	GA
az appconfig identity show	顯示應用程式組態存放區的受控識別。	Core	GA
az appconfig kv	管理儲存在應用程式組態存放區中的索引鍵/值。	Core	GA
az appconfig kv delete	Delete key-values.	Core	GA
az appconfig kv export	從應用程式組態存放區將組態匯出至另一個位置。	Core	GA
az appconfig kv import	從另一個地方將設定匯入應用程式組態存放區。	Core	GA
az appconfig kv list	List key-values.	Core	GA
az appconfig kv lock	鎖定索引鍵/值以禁止寫入作業。	Core	GA
az appconfig kv restore	Restore key-values.	Core	GA
az appconfig kv set	設定索引鍵/值。	Core	GA
az appconfig kv set-keyvault	設定keyvault參考。	Core	GA
az appconfig kv show	顯示索引鍵/值的所有屬性。	Core	GA
az appconfig kv unlock	解除鎖定索引鍵/值以取得寫入作業。	Core	GA
az appconfig list	列出目前訂用帳戶下的所有應用程式組態存放區。	Core	GA
az appconfig list-deleted	列出所有已刪除但尚未清除的應用程式組態存放區。	Core	GA
az appconfig purge	永久刪除應用程式組態存放區。也稱為「清除」已刪除的應用程式組態存放區。	Core	GA
az appconfig recover	復原先前已刪除但尚未清除的應用程式組態存放區。	Core	GA
az appconfig replica	管理應用程式組態存放區的複本。	Core	GA
az appconfig replica create	建立應用程式組態存放區的新複本。	Core	GA
az appconfig replica delete	刪除應用程式組態存放區的複本。	Core	GA
az appconfig replica list	列出應用程式組態存放區的複本。	Core	GA
az appconfig replica show	顯示應用程式組態存放區複本的詳細數據。	Core	GA
az appconfig revision	管理儲存在應用程式組態存放區中的索引鍵/值修訂。	Core	GA
az appconfig revision list	列出索引鍵/值的修訂歷程記錄。	Core	GA
az appconfig show	顯示應用程式組態存放區的屬性。	Core	GA
az appconfig show-deleted	顯示已刪除但尚未清除的應用程式組態存放區的屬性。	Core	GA
az appconfig snapshot	管理與應用程式組態存放區相關聯的快照集。	Core	GA
az appconfig snapshot archive	封存快照集。	Core	GA
az appconfig snapshot create	建立應用程式設定快照集。	Core	GA
az appconfig snapshot list	List snapshots.	Core	GA
az appconfig snapshot recover	復原封存的快照集。	Core	GA
az appconfig snapshot show	顯示應用程式組態快照集的所有屬性。	Core	GA
az appconfig update	更新應用程式組態存放區。	Core	GA

az appconfig create

編輯

建立應用程式組態。

az appconfig create --location
                    --name
                    --resource-group
                    [--arm-auth-mode {local, pass-through}]
                    [--assign-identity]
                    [--disable-local-auth {false, true}]
                    [--enable-arm-private-network-access {false, true}]
                    [--enable-public-network {false, true}]
                    [--enable-purge-protection {false, true}]
                    [--no-replica {false, true}]
                    [--replica-location]
                    [--replica-name]
                    [--retention-days]
                    [--sku {Developer, Free, Premium, Standard}]
                    [--tags]

範例

建立名稱、位置、sku、標籤和資源群組的應用程式組態存放區。

az appconfig create -g MyResourceGroup -n MyAppConfiguration -l westus --sku Standard --tags key1=value1 key2=value2

使用開發人員 SKU 建立應用程式配置存儲

az appconfig create -g MyResourceGroup -n MyAppConfiguration -l westus --sku Developer

使用複本建立進階 SKU 應用程式組態存放區

az appconfig create -g MyResourceGroup -n MyAppConfiguration -l westus --sku Premium --replica-name MyReplica --replica-location eastus

建立沒有復本的進階 SKU 應用程式組態存放區

az appconfig create -g MyResourceGroup -n MyAppConfiguration -l westus --sku Premium --no-replica

使用系統指派的身分識別，建立名稱、位置、SKU 和資源群組的應用程式組態存放區。

az appconfig create -g MyResourceGroup -n MyAppConfiguration -l westus --sku Standard --assign-identity

使用使用者指派的身分識別，建立名稱、位置、SKU 和資源群組的應用程式組態存放區。

az appconfig create -g MyResourceGroup -n MyAppConfiguration -l westus --sku Standard --assign-identity /subscriptions/<SUBSCRIPTON ID>/resourcegroups/<RESOURCEGROUP>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myUserAssignedIdentity

使用已啟用公用網路存取和停用本機驗證的名稱、位置和資源群組，建立應用程式組態存放區。

az appconfig create -g MyResourceGroup -n MyAppConfiguration -l westus --enable-public-network --disable-local-auth

建立名稱、位置和資源群組的應用程式組態存放區，並將ARM驗證模式設定為傳遞。

az appconfig create -g MyResourceGroup -n MyAppConfiguration -l westus --arm-auth-mode pass-through

建立名稱、位置和資源群組的應用程式組態存放區，並將ARM驗證模式設定為已啟用ARM Private Link的傳遞和專用網存取。

az appconfig create -g MyResourceGroup -n MyAppConfiguration -l westus --arm-auth-mode pass-through --enable-arm-private-network-access true

必要參數

--location -l

Location. 值的來源：az account list-locations。您可以使用 az configure --defaults location=<location>來設定預設位置。

--name -n

應用程式組態存放區的名稱。您可以使用 az configure --defaults app_configuration_store=<name>來設定預設名稱。

--resource-group -g

資源組名。您可以使用 az configure --defaults group=<name>來設定預設群組。

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--arm-auth-mode

透過 ARM 存取應用程式組態存放區的驗證模式。「傳遞」（建議）會使用Microsoft Entra ID，透過ARM使用適當的授權存取存放區。'local' 會使用存取密鑰進行驗證。這需要啟用存取金鑰。

屬性	值
接受的值:	local, pass-through

--assign-identity

要指派的受控識別空間分隔清單。使用「[system]」來參考系統指派的受控識別或資源識別碼，以參考使用者指派的受控識別。如果未提供此自變數，預設會指派系統指派的受控識別。如果未提供此自變數，則不會將受控識別指派給此應用程式組態存放區。

--disable-local-auth

停用 AAD 驗證以外的所有驗證方法。

屬性	值
接受的值:	false, true

--enable-arm-private-network-access

如果資源受限於專用網存取，請透過ARM Private Link啟用應用程式組態存放區的存取。需要傳遞 ARM 驗證模式。

屬性	值
接受的值:	false, true

--enable-public-network -e

如果為 true，來自公用網路的要求有權在啟用私人端點時存取此存放區。若為 false，則只有透過 Private Link 提出的要求才能連線到此存放區。

屬性	值
接受的值:	false, true

--enable-purge-protection -p

屬性，指定是否為此應用程式組態存放區啟用清除保護。將此屬性設定為 true 可啟用保護，以防止清除此應用程式組態存放區及其內容。啟用這項功能是無法復原的。

屬性	值
接受的值:	false, true

--no-replica

繼續進行，但不建立進階層存放區的複本。

屬性	值
接受的值:	false, true

--replica-location

應用程式組態存放區複本的位置。

--replica-name

應用程式組態存放區複本的名稱。

--retention-days

刪除後保留已啟用虛刪除的應用程式組態存放區天數。必須是介於 0 到 7 之間的正整數。

--sku

應用程式組態存放區的 SKU。

屬性	值
預設值:	Standard
接受的值:	Developer, Free, Premium, Standard

--tags

以空格分隔的標記：key[=value] [key[=value] ...]。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az appconfig delete

編輯

刪除應用程式組態存放區。

az appconfig delete --name
                    [--resource-group]
                    [--yes]

範例

刪除資源群組下的應用程式組態存放區

az appconfig delete -g MyResourceGroup -n MyAppConfiguration

必要參數

--name -n

應用程式組態存放區的名稱。您可以使用 az configure --defaults app_configuration_store=<name>來設定預設名稱。

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--resource-group -g

資源組名。您可以使用 az configure --defaults group=<name>來設定預設群組。

--yes -y

請勿提示確認。

屬性	值
預設值:	False

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az appconfig list

編輯

列出目前訂用帳戶下的所有應用程式組態存放區。

az appconfig list [--resource-group]

範例

列出資源群組下的所有應用程式組態存放區

az appconfig list -g MyResourceGroup

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--resource-group -g

資源組名。您可以使用 az configure --defaults group=<name>來設定預設群組。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az appconfig list-deleted

編輯

列出所有已刪除但尚未清除的應用程式組態存放區。

az appconfig list-deleted

範例

列出所有已刪除但尚未清除的應用程式組態存放區。

az appconfig list-deleted

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az appconfig purge

編輯

永久刪除應用程式組態存放區。也稱為「清除」已刪除的應用程式組態存放區。

az appconfig purge --name
                   [--location]
                   [--yes]

範例

清除名為『sample-app-configuration』的已刪除應用程式組態存放區。

az appconfig purge --name sample-app-configuration

必要參數

--name -n

應用程式組態存放區的名稱。您可以使用 az configure --defaults app_configuration_store=<name>來設定預設名稱。

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--location -l

已刪除應用程式組態存放區的位置。可以使用命令 az appconfig show-deleted來檢視。

--yes -y

請勿提示確認。

屬性	值
預設值:	False

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az appconfig recover

編輯

復原先前已刪除但尚未清除的應用程式組態存放區。

az appconfig recover --name
                     [--location]
                     [--resource-group]
                     [--yes]

範例

復原名為 'sample-app-configuration' 的已刪除應用程式組態存放區。

az appconfig recover --name sample-app-configuration

必要參數

--name -n

應用程式組態存放區的名稱。您可以使用 az configure --defaults app_configuration_store=<name>來設定預設名稱。

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--location -l

已刪除應用程式組態存放區的位置。可以使用命令 az appconfig show-deleted來檢視。

--resource-group -g

已刪除應用程式組態存放區的資源群組。

--yes -y

請勿提示確認。

屬性	值
預設值:	False

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az appconfig show

編輯

顯示應用程式組態存放區的屬性。

az appconfig show --name
                  [--resource-group]

範例

顯示應用程式組態存放區的屬性

az appconfig show -g MyResourceGroup -n MyAppConfiguration

必要參數

--name -n

應用程式組態存放區的名稱。您可以使用 az configure --defaults app_configuration_store=<name>來設定預設名稱。

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--resource-group -g

資源組名。您可以使用 az configure --defaults group=<name>來設定預設群組。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az appconfig show-deleted

編輯

顯示已刪除但尚未清除的應用程式組態存放區的屬性。

az appconfig show-deleted --name
                          [--location]

範例

顯示名為『sample-app-configuration』之已刪除應用程式組態存放區的屬性。

az appconfig show-deleted --name sample-app-configuration

必要參數

--name -n

應用程式組態存放區的名稱。您可以使用 az configure --defaults app_configuration_store=<name>來設定預設名稱。

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--location -l

已刪除應用程式組態存放區的位置。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az appconfig update

編輯

更新應用程式組態存放區。

az appconfig update --name
                    [--arm-auth-mode {local, pass-through}]
                    [--disable-local-auth {false, true}]
                    [--enable-arm-private-network-access {false, true}]
                    [--enable-public-network {false, true}]
                    [--enable-purge-protection {false, true}]
                    [--encryption-key-name]
                    [--encryption-key-vault]
                    [--encryption-key-version]
                    [--identity-client-id]
                    [--resource-group]
                    [--sku {Developer, Free, Premium, Standard}]
                    [--tags]

範例

更新應用程式組態存放區的標記

az appconfig update -g MyResourceGroup -n MyAppConfiguration --tags key1=value1 key2=value2

將應用程式組態存放區的 SKU 升級至標準層

az appconfig update -g MyResourceGroup -n MyAppConfiguration --sku Standard

將應用程式組態存放區的 SKU 升級至進階層

az appconfig update -g MyResourceGroup -n MyAppConfiguration --sku Premium

使用系統指派的身分識別啟用客戶加密金鑰

az appconfig update -g MyResourceGroup -n MyAppConfiguration --encryption-key-name myKey --encryption-key-version keyVersion --encryption-key-vault https://keyVaultName.vault.azure.net

拿掉客戶加密金鑰

az appconfig update -g MyResourceGroup -n MyAppConfiguration --encryption-key-name ""

更新應用程式組態存放區以啟用公用網路存取，並停用本機驗證。

az appconfig update -g MyResourceGroup -n MyAppConfiguration --enable-public-network true --disable-local-auth true

更新應用程式組態存放區，將 ARM 驗證模式設定為傳遞。

az appconfig update -g MyResourceGroup -n MyAppConfiguration --arm-auth-mode pass-through

更新應用程式組態存放區，將ARM驗證模式設定為傳遞，並透過ARM Private Link啟用專用網存取。

az appconfig update -g MyResourceGroup -n MyAppConfiguration --arm-auth-mode pass-through --enable-arm-private-network-access true

必要參數

--name -n

應用程式組態存放區的名稱。您可以使用 az configure --defaults app_configuration_store=<name>來設定預設名稱。

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--arm-auth-mode

屬性	值
接受的值:	local, pass-through

--disable-local-auth

停用 AAD 驗證以外的所有驗證方法。

屬性	值
接受的值:	false, true

--enable-arm-private-network-access

如果資源受限於專用網存取，請透過ARM Private Link啟用應用程式組態存放區的存取。需要傳遞 ARM 驗證模式。

屬性	值
接受的值:	false, true

--enable-public-network -e

如果為 true，來自公用網路的要求有權在啟用私人端點時存取此存放區。若為 false，則只有透過 Private Link 提出的要求才能連線到此存放區。

屬性	值
接受的值:	false, true

--enable-purge-protection -p

屬性	值
接受的值:	false, true

--encryption-key-name

KeyVault 金鑰的名稱。

屬性	值
Parameter group:	Customer Managed Key Arguments

--encryption-key-vault

KeyVault 的 URI。

屬性	值
Parameter group:	Customer Managed Key Arguments

--encryption-key-version

KeyVault 金鑰的版本。預設使用最新版本。

屬性	值
Parameter group:	Customer Managed Key Arguments

--identity-client-id

受控識別的用戶端標識碼，並包裝和解除包裝加密密鑰的存取權。預設使用系統指派的受控識別。

屬性	值
Parameter group:	Customer Managed Key Arguments

--resource-group -g

資源組名。您可以使用 az configure --defaults group=<name>來設定預設群組。

--sku

應用程式組態存放區的 SKU。

屬性	值
接受的值:	Developer, Free, Premium, Standard

--tags

以空格分隔的標記：key[=value] [key[=value] ...]。使用「清除現有的標記」。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

共用方式為

az appconfig

命令

az appconfig create

範例

必要參數

選擇性參數

az appconfig delete

範例

必要參數

選擇性參數

az appconfig list

範例

選擇性參數

az appconfig list-deleted

範例

az appconfig purge

範例

必要參數

選擇性參數

az appconfig recover

範例

必要參數

選擇性參數

az appconfig show

範例

必要參數

選擇性參數

az appconfig show-deleted

範例

必要參數

選擇性參數

az appconfig update

範例

必要參數

選擇性參數

意見反應