Get-AzTemplateSpec
取得或列出範本規格
語法
Get-AzTemplateSpec
[[-ResourceGroupName] <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzTemplateSpec
[-ResourceGroupName] <String>
[-Name] <String>
[[-Version] <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzTemplateSpec
[[-Version] <String>]
[-ResourceId] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Description
此 Cmdlet 可用來列出訂用帳戶/資源群組中的範本規格，或依名稱或標識碼取得特定的範本規格。取得特定範本規格的名稱/標識符時，可以透過 -Version 參數指定版本名稱 ，選擇性地擷取特定版本 。 使用 -Version 時，只有特定版本詳細數據會出現在 *中。傳回的 Template Spec 物件上的版本。 如果在依名稱/標識符擷取範本規格時未指定任何特定版本，則所有版本都會出現在 *中。傳回物件的 Versions 屬性。
注意：列出訂用帳戶或資源群組內的所有範本規格時，每個範本規格都會傳回的 “。Versions“ 屬性會是 Null。 只有在提供 -Name 或 -ResourceId 參數時，才會包含版本資訊（例如：您要求特定的範本規格/版本）。
範例
範例 1：列出目前訂用帳戶中的範本規格
Get-AzTemplateSpec列出目前訂用帳戶中的所有範本規格。
範例 2：列出資源群組中的範本規格
Get-AzTemplateSpec -ResourceGroupName 'myRG'列出目前訂用帳戶資源群組 『myRG』 中的所有範本規格。
範例 3：依名稱取得範本規格（含所有版本）
Get-AzTemplateSpec -ResourceGroupName 'myRG' -Name 'MyTemplateSpec'取得資源群組 'myRG' 內名為 'MyTemplateSpec' 的範本規格相關信息。
注意：所有範本規格的版本都會出現在 “ 內。Return 物件的 Versions“ 屬性。
範例 4：依名稱取得範本規格（特定版本）
Get-AzTemplateSpec -ResourceGroupName 'myRG' -Name 'MyTemplateSpec' -Version 'v1.0'取得資源群組 'myRG' 內名為 'MyTemplateSpec' 之範本規格版本 'v1.0' 的相關信息。
注意： “。傳回物件的 Versions“ 屬性只會包含所要求的特定版本。
範例 5：依資源識別碼取得範本規格（含所有版本）
Get-AzTemplateSpec -ResourceId '/subscriptions/{subId}/resourceGroups/myRG/providers/Microsoft.Resources/templateSpecs/MyTemplateSpec'取得訂用帳戶 {subId} 資源群組 'myRG' 內名為 'MyTemplateSpec' 的範本規格相關信息。
注意：所有範本規格的版本都會出現在 “ 內。Return 物件的 Versions“ 屬性。
範例 6：依資源識別碼取得範本規格（特定版本）
Get-AzTemplateSpec -ResourceId '/subscriptions/{subId}/resourceGroups/myRG/providers/Microsoft.Resources/templateSpecs/MyTemplateSpec' -Version 'v1.0'取得訂用帳戶 {subId} 資源群組 'myRG' 內名為 'MyTemplateSpec' 之範本規格版本 'v1.0' 的相關信息。
注意： “。傳回物件的 Versions“ 屬性只會包含所要求的特定版本。
參數
-DefaultProfile
用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。
| 類型: | IAzureContextContainer |
| 別名: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Name
範本規格的名稱。
| 類型: | String |
| Position: | 1 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ResourceGroupName
資源群組的名稱。
| 類型: | String |
| Position: | 0 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ResourceId
範本規格的完整資源標識符。範例：/subscriptions/{subId}/resourceGroups/{rgName}/providers/Microsoft.Resources/templateSpecs/{templateSpecName}
| 類型: | String |
| 別名: | Id |
| Position: | 0 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Version
範本規格的版本。
| 類型: | String |
| Position: | 2 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
