Get-AzTemplateSpec

參考

模組:: Az.Resources

取得或列出範本規格

Syntax

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 通訊的認證、帳戶、租用戶和訂用帳戶。

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

範本規格的名稱。

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ResourceGroupName

資源群組的名稱。

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ResourceId

範本規格的完整資源標識符。範例：/subscriptions/{subId}/resourceGroups/{rgName}/providers/Microsoft.Resources/templateSpecs/{templateSpecName}

Type:	String
Aliases:	Id
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Version

範本規格的版本。

Type:	String
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

輸入

String

輸出

PSTemplateSpec