Export-AzResourceGroup

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

Записывает группу ресурсов в виде шаблона и сохраняет ее в файл.

Синтаксис

Export-AzResourceGroup
      -ResourceGroupName <String>
      [-Path <String>]
      [-IncludeParameterDefaultValue]
      [-IncludeComments]
      [-SkipResourceNameParameterization]
      [-SkipAllParameterization]
      [-Resource <String[]>]
      [-Force]
      [-ApiVersion <String>]
      [-Pre]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Описание

Командлет Export-AzResourceGroup записывает указанную группу ресурсов в виде шаблона и сохраняет ее в JSON-файл. Это может быть полезно в сценариях, когда вы уже создали некоторые ресурсы в группе ресурсов, а затем хотите использовать преимущества использования поддерживаемых шаблонов развертываний. Этот командлет позволяет легко начать с создания шаблона для существующих ресурсов в группе ресурсов. В некоторых случаях этот командлет не может создать некоторые части шаблона. Предупреждающие сообщения будут сообщать вам о ресурсах, которые не удалось выполнить. Шаблон по-прежнему будет создан для частей, которые были успешными.

Примеры

Пример 1. Экспорт группы ресурсов

Export-AzResourceGroup -ResourceGroupName "TestGroup"

Эта команда записывает группу ресурсов с именем TestGroup в качестве шаблона и сохраняет ее в JSON-файл в текущем каталоге.

Пример 2. Экспорт одного ресурса из группы ресурсов

Export-AzResourceGroup -ResourceGroupName "TestGroup" -Resource "/subscriptions/5f43547b-1d2d-4a3e-ace4-88d4b600d568/resourceGroups/TestGroup/providers/Microsoft.Compute/virtualMachines/TestVirtualMachine"

Эта команда записывает ресурс виртуальной машины с именем TestVirtualMachine из группы ресурсов TestGroup в качестве шаблона и сохраняет его в JSON-файл в текущем каталоге.

Пример 3. Экспорт выбора ресурсов из группы ресурсов

Export-AzResourceGroup -ResourceGroupName "TestGroup" -SkipAllParameterization -Resource @(
  "/subscriptions/5f43547b-1d2d-4a3e-ace4-88d4b600d568/resourceGroups/TestGroup/providers/Microsoft.Compute/virtualMachines/TestVm",
  "/subscriptions/5f43547b-1d2d-4a3e-ace4-88d4b600d568/resourceGroups/TestGroup/providers/Microsoft.Network/networkInterfaces/TestNic"
)

Эта команда записывает два ресурса из группы ресурсов TestGroup в качестве шаблона и сохраняет его в JSON-файл в текущем каталоге. Созданный шаблон не будет содержать созданные параметры.

Параметры

-ApiVersion

Указывает версию API поставщика ресурсов для использования. Если не указано, используется последняя версия API.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Запрос подтверждения перед выполнением командлета.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Принудительное выполнение команды без запроса на подтверждение пользователем.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IncludeComments

Указывает, что эта операция экспортирует шаблон с комментариями.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IncludeParameterDefaultValue

Указывает, что эта операция экспортирует параметр шаблона со значением по умолчанию.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Указывает выходной путь файла шаблона.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Pre

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Resource

Список идентификаторов ресурсов для фильтрации результатов.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

Указывает имя группы ресурсов для экспорта.

Type:String
Aliases:ResourceGroup
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SkipAllParameterization

Пропустить все параметризация.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipResourceNameParameterization

Пропустите параметризацию имени ресурса.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Показывает, что произойдет при запуске командлета. Командлет не выполняется.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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

String

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

PSObject