az ts

  • 參考

管理訂用帳戶或資源群組範圍的範本規格。

命令

名稱 Description 類型 狀態
az ts create

建立範本規格和或範本規格版本。

 核心 GA
az ts delete

依名稱或資源識別碼刪除指定的範本規格或範本規格版本。

 核心 GA
az ts export

將指定的範本規格版本和成品（如果有的話）匯出至指定的輸出檔案夾。

 核心 GA
az ts list

列出範本規格或範本規格版本。

 核心 GA
az ts show

取得指定的範本規格或範本規格版本。

 核心 GA
az ts update

更新範本規格版本。

 核心 GA

az ts create

建立範本規格和或範本規格版本。

az ts create --name
             --resource-group
             [--description]
             [--display-name]
             [--location]
             [--tags]
             [--template-file]
             [--ui-form-definition]
             [--version]
             [--version-description]
             [--yes]

範例

建立範本規格。

az ts create -g testRG --name TemplateSpecName -l WestUS --display-name "MyDisplayName" --description "Simple template spec" --tags key1=value1

建立範本規格版本。

az ts create -g testRG --name TemplateSpecName -v 2.0 -l WestUS --template-file templateSpec.json --version-description "Less simple template spec" --tags key1=value1 key3=value3

建立範本規格和範本規格的版本。

az ts create -g testRG --name TemplateSpecName -v 1.0 -l WestUS --template-file templateSpec.json --display-name "MyDisplayName" --description "Simple template spec" --version-description "Version of simple template spec" --tags key1=value1 key2=value2

必要參數

--name -n

範本規格的名稱。

--resource-group -g

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

選擇性參數

--description

父範本規格的描述。

--display-name -d

範本規格的顯示名稱。

--location -l

儲存範本規格和範本規格版本的位置。 建立之後無法變更。

--tags

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

--template-file -f

檔案系統中範本檔案或 Bicep 檔案的路徑。

--ui-form-definition

範本規格版本的檔案系統中的 uiFormDefinition 檔案路徑。

--version -v

範本規格版本。

--version-description

範本規格版本的描述。

--yes -y

不提示確認。

預設值: False
全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az ts delete

依名稱或資源識別碼刪除指定的範本規格或範本規格版本。

az ts delete [--name]
             [--resource-group]
             [--template-spec]
             [--version]
             [--yes]

範例

刪除指定的範本規格和所有版本。

az ts delete -g MyResourceGroup --name TemplateSpecName

從範本規格中刪除指定的版本。

az ts delete -g MyResourceGroup --name TemplateSpecName --version VersionName

根據資源識別碼刪除範本規格或版本。

az ts delete --template-spec resourceID

選擇性參數

--name -n

範本規格的名稱。

--resource-group -g

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

--template-spec -s

範本規格資源識別碼。

--version -v

範本規格版本。

--yes -y

不提示確認。

預設值: False
全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az ts export

將指定的範本規格版本和成品（如果有的話）匯出至指定的輸出檔案夾。

az ts export --output-folder
             [--name]
             [--resource-group]
             [--template-spec]
             [--version]

範例

根據資源識別碼匯出指定的範本規格版本。

az ts export -s resourceID --output-folder C:/path/

匯出指定的範本規格版本。

az ts export -g testrg --name TemplateSpecName --version VersionName --output-folder C:/path/

必要參數

--output-folder

要輸出 export（s） 的現有資料夾。

選擇性參數

--name -n

範本規格的名稱。

--resource-group -g

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

--template-spec -s

範本規格資源識別碼。

--version -v

範本規格版本。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az ts list

列出範本規格或範本規格版本。

az ts list [--name]
           [--resource-group]

範例

列出目前預設訂用帳戶中的所有範本規格。

az ts list

列出指定訂用帳戶中的所有範本規格。

az ts list --subscription Subscription

列出資源群組中的所有範本規格。

az ts list -g MyResourceGroup

列出父範本規格的所有版本。

az ts list -g MyResourceGroup -n TemplateSpecName

選擇性參數

--name -n

範本規格的名稱。

--resource-group -g

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

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az ts show

取得指定的範本規格或範本規格版本。

az ts show [--name]
           [--resource-group]
           [--template-spec]
           [--version]

範例

顯示指定的範本規格。

az ts show -g testrg --name TemplateSpecName

顯示指定的範本規格版本。

az ts show -g testrg --name TemplateSpecName --version VersionName

根據資源識別碼顯示指定的範本規格或範本規格版本。

az ts show --template-spec resourceID

選擇性參數

--name -n

範本規格的名稱。

--resource-group -g

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

--template-spec -s

範本規格資源識別碼。

--version -v

範本規格版本。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az ts update

更新範本規格版本。

az ts update [--description]
             [--display-name]
             [--name]
             [--resource-group]
             [--tags]
             [--template-file]
             [--template-spec]
             [--ui-form-definition]
             [--version]
             [--version-description]
             [--yes]

範例

根據資源識別碼更新範本規格或範本規格版本的範本內容。

az ts update --template-spec resourceID -f updatedFile.json

根據資源識別碼更新範本規格的顯示名稱和標記。

az ts update --template-spec resourceID --display-name "NewParentDisplayName" --tags key1=value1

更新範本規格版本的描述，但未提示。

az ts update -g ExistingRG --name ExistingName -v 3.0 --version-description "New description" --yes

更新範本規格版本的所有屬性。

az ts update -g ExistingRG --name ExistingName -v 3.0 -f updatedTemplate.json --display-name "New parent display name" --description "New parent description" --version-description "New child description" --ui-form-definition formDefinition.json

從範本規格版本移除標籤，但未提示。

az ts update -g ExistingRG --name ExistingName -v 3.0 -f updatedTemplate.json --tags --yes

選擇性參數

--description

父範本規格的描述。

--display-name -d

範本規格的顯示名稱。

--name -n

範本規格的名稱。

--resource-group -g

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

--tags

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

--template-file -f

檔案系統中範本檔案或 Bicep 檔案的路徑。

--template-spec -s

範本規格資源識別碼。

--ui-form-definition

範本規格版本的檔案系統中的 uiFormDefinition 檔案路徑。

--version -v

範本規格版本。

--version-description

範本規格版本的描述。

--yes -y

不提示確認。

預設值: False
全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。