Поделиться через


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>]

Описание

Этот командлет можно использовать для перечисления спецификаций шаблонов в подписке или группе ресурсов или получения определенной спецификации шаблона по имени или идентификатору. При получении определенной спецификации шаблона по имени или идентификатору определенной версии можно получить, указав имя версии с помощью параметра -Version. Если используется -Version, в пределах *будут представлены только сведения о конкретной версии. Версии в возвращаемом объекте Template Spec. Если при получении спецификации шаблона по имени или идентификатору не указана определенная версия, все версии будут присутствовать в* . Версии свойство возвращаемого объекта.

примечание. При перечислении всех спецификаций шаблонов в подписке или группе ресурсов каждая возвращаемая спецификация шаблона ". Свойства versions будут null. Сведения о версии включаются только в том случае, если предоставляются -Name или -ResourceId параметры (например, запрашиваете определенную спецификацию или версию шаблона).

Примеры

Пример 1. Список спецификаций шаблонов в текущей подписке

Get-AzTemplateSpec

Выводит список всех спецификаций шаблонов в текущей подписке.

Пример 2. Перечисление спецификаций шаблонов в группе ресурсов

Get-AzTemplateSpec -ResourceGroupName 'myRG'

Перечисляет все спецификации шаблонов в группе ресурсов myRG текущей подписки.

Пример 3. Получение спецификации шаблона (со всеми версиями) по имени

Get-AzTemplateSpec -ResourceGroupName 'myRG' -Name 'MyTemplateSpec'

Возвращает сведения о спецификации шаблона с именем MyTemplateSpec в группе ресурсов myRG.

примечание: все версии спецификации шаблона будут присутствовать в. Версии" свойство возвращаемого объекта.

Пример 4. Получение спецификации шаблона (конкретная версия) по имени

Get-AzTemplateSpec -ResourceGroupName 'myRG' -Name 'MyTemplateSpec' -Version 'v1.0'

Возвращает сведения о версии 1.0 спецификации шаблона с именем MyTemplateSpec в группе ресурсов myRG.

Примечание: ". Версии" свойство возвращаемого объекта будет содержать только запрошенную версию.

Пример 5. Получение спецификации шаблона (со всеми версиями) по идентификатору ресурса

Get-AzTemplateSpec -ResourceId '/subscriptions/{subId}/resourceGroups/myRG/providers/Microsoft.Resources/templateSpecs/MyTemplateSpec'

Возвращает сведения о спецификации шаблона с именем MyTemplateSpec в группе ресурсов myRG подписки {subId}.

примечание: все версии спецификации шаблона будут присутствовать в. Версии" свойство возвращаемого объекта.

Пример 6. Получение спецификации шаблона (определенная версия) по идентификатору ресурса

Get-AzTemplateSpec -ResourceId '/subscriptions/{subId}/resourceGroups/myRG/providers/Microsoft.Resources/templateSpecs/MyTemplateSpec' -Version 'v1.0'

Возвращает сведения о версии 1.0 спецификации шаблона с именем MyTemplateSpec в группе ресурсов myRG подписки {subId}.

Примечание: ". Версии" свойство возвращаемого объекта будет содержать только запрошенную версию.

Параметры

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для взаимодействия с Azure.

Тип:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Name

Имя спецификации шаблона.

Тип:String
Position:1
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ResourceGroupName

Имя группы ресурсов.

Тип:String
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ResourceId

Полный идентификатор ресурса спецификации шаблона. Пример: /subscriptions/{subId}/resourceGroups/{rgName}/providers/Microsoft.Resources/templateSpecs/{templateSpecName}

Тип:String
Aliases:Id
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Version

Версия спецификации шаблона.

Тип:String
Position:2
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

Входные данные

String

Выходные данные

PSTemplateSpec