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

Get-AzTemplateSpec

  • Ссылка
Модуль:
Az.Resources

Возвращает или перечисляет спецификации шаблонов

Синтаксис

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 возвращаемого объекта.

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

Примеры

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

Get-AzTemplateSpec

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

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

Get-AzTemplateSpec -ResourceGroupName 'myRG'

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Параметры

-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