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>]
Описание
Этот командлет можно использовать для перечисления спецификаций шаблонов в подписке или группе ресурсов или получения определенной спецификации шаблона по имени или идентификатору. При получении определенной спецификации шаблона по имени или идентификатору определенной версии можно получить, указав имя версии с помощью параметра -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 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Name
Имя спецификации шаблона.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
GetTemplateSpecByNameParameterSet
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-ResourceGroupName
Имя группы ресурсов.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
ListTemplateSpecsParameterSet
| Position: | 0 |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-ResourceId
Полный идентификатор ресурса спецификации шаблона. Пример: /subscriptions/{subId}/resourceGroups/{rgName}/providers/Microsoft.Resources/templateSpecs/{templateSpecName}
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | Идентификатор |
Наборы параметров
GetTemplateSpecByIdParameterSet
| Position: | 0 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Version
Версия спецификации шаблона.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
GetTemplateSpecByNameParameterSet
| Position: | 2 |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
GetTemplateSpecByIdParameterSet
| Position: | 2 |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.