az ts

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

命令

名稱	Description	類型	狀態
az ts create	建立範本規格和或範本規格版本。	Core	GA
az ts delete	依名稱或資源標識碼刪除指定的範本規格或範本規格版本。	Core	GA
az ts export	將指定的範本規格版本和成品（如果有的話）匯出至指定的輸出資料夾。	Core	GA
az ts list	列出範本規格或範本規格版本。	Core	GA
az ts show	取得指定的範本規格或範本規格版本。	Core	GA
az ts update	更新範本規格版本。	Core	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

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

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	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 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

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

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	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 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

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

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	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 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

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

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	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 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

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

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	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 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

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

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	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 ts

命令

az ts create

範例

必要參數

選擇性參數

az ts delete

範例

選擇性參數

az ts export

範例

必要參數

選擇性參數

az ts list

範例

選擇性參數

az ts show

範例

選擇性參數

az ts update

範例

選擇性參數

意見反應