Get-AzTemplateSpec
获取或列出模板规格
语法
ListTemplateSpecsParameterSet (默认值)
Get-AzTemplateSpec
[[-ResourceGroupName] <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
GetTemplateSpecByNameParameterSet
Get-AzTemplateSpec
[-ResourceGroupName] <String>
[-Name] <String>
[[-Version] <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
GetTemplateSpecByIdParameterSet
Get-AzTemplateSpec
[[-Version] <String>]
[-ResourceId] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
说明
此 cmdlet 可用于列出订阅/资源组中的模板规格,或按名称或 ID 获取特定的模板规格。当按名称/ID 获取特定模板规格时,可以通过 通过 -Version 参数指定版本名称来检索特定版本。 使用 -Version 时,只有特定版本详细信息才会出现在 *中。 返回的模板规格对象上的版本。 如果在按名称/ID 检索模板规格时未指定任何特定版本,则 *中将存在所有版本。 返回对象的 Versions 属性。
注意:列出订阅或资源组中的所有模板规格时,每个模板规格都返回 了“。Versions“ 属性将为 null。 仅当提供 -Name 或 -ResourceId 参数时(例如:请求特定模板规格/版本)时,才会包含版本信息。
示例
示例 1:列出当前订阅中的模板规格
Get-AzTemplateSpec
列出当前订阅中的所有模板规格。
示例 2:列出资源组中的模板规格
Get-AzTemplateSpec -ResourceGroupName 'myRG'
列出当前订阅的资源组“myRG”中的所有模板规格。
示例 3:按名称获取模板规格(包含所有版本)
Get-AzTemplateSpec -ResourceGroupName 'myRG' -Name 'MyTemplateSpec'
获取有关资源组“myRG”中名为“MyTemplateSpec”的模板规格的信息。
注意:模板规格的所有版本都将出现在“内。返回对象的 Versions“属性。
示例 4:按名称获取模板规格(特定版本)
Get-AzTemplateSpec -ResourceGroupName 'myRG' -Name 'MyTemplateSpec' -Version 'v1.0'
获取资源组“myRG”中名为“MyTemplateSpec”的模板规格的版本“v1.0”的相关信息。
注意: “。返回对象的 Versions“ 属性将仅包含所请求的特定版本。
示例 5:按资源 ID 获取模板规格(包含所有版本)
Get-AzTemplateSpec -ResourceId '/subscriptions/{subId}/resourceGroups/myRG/providers/Microsoft.Resources/templateSpecs/MyTemplateSpec'
获取有关订阅 {subId} 资源组“myRG”中名为“MyTemplateSpec”的模板规格的信息。
注意:模板规格的所有版本都将出现在“内。返回对象的 Versions“属性。
示例 6:按资源 ID 获取模板规格(特定版本)
Get-AzTemplateSpec -ResourceId '/subscriptions/{subId}/resourceGroups/myRG/providers/Microsoft.Resources/templateSpecs/MyTemplateSpec' -Version 'v1.0'
获取有关订阅 {subId} 资源组“myRG”中名为“MyTemplateSpec”的模板规格的版本“v1.0”的信息。
注意: “。返回对象的 Versions“ 属性将仅包含所请求的特定版本。
参数
-DefaultProfile
用于与 Azure 通信的凭据、帐户、租户和订阅。
参数属性
| 类型: | IAzureContextContainer |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | AzContext, AzureRmContext, AzureCredential |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Name
模板规格的名称。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
GetTemplateSpecByNameParameterSet
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
-ResourceGroupName
资源组的名称。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
ListTemplateSpecsParameterSet
| Position: | 0 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
-ResourceId
模板规格的完全限定资源 ID。示例:/subscriptions/{subId}/resourceGroups/{rgName}/providers/Microsoft.Resources/templateSpecs/{templateSpecName}
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | Id |
参数集
GetTemplateSpecByIdParameterSet
| Position: | 0 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
-Version
模板规格的版本。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
GetTemplateSpecByNameParameterSet
| Position: | 2 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
GetTemplateSpecByIdParameterSet
| Position: | 2 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters。