你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

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

输入

String

输出

PSTemplateSpec