Compartilhar via

Importar e exportar definições do blueprint com o PowerShell

  • Artigo

Importante

Em 11 de julho de 2026, o Blueprints (versão prévia) será preterido. Migre suas definições e atribuições de blueprint existentes para Especificações de Modelo e Pilhas de Implantação. Os artefatos de blueprint devem ser convertidos em modelos JSON do ARM ou arquivos Bicep usados para definir pilhas de implantação. Para saber como criar um artefato como um recurso do ARM, confira:

Os Azure Blueprints podem ser totalmente gerenciados por meio de portal do Azure. À medida que as organizações avançam em seu uso do Azure Blueprints, elas devem começar a pensar em definições de blueprint como código gerenciado. Esse conceito é geralmente chamado de infraestrutura como código (IaC). Tratar suas definições de blueprint como código oferece vantagens adicionais além do que portal do Azure oferece. Esses benefícios incluem:

  • Compartilhar definições de blueprint
  • Fazendo backup de suas definições de blueprint
  • Reutilizando definições de blueprint em diferentes locatários ou assinaturas
  • Colocando as definições do blueprint no controle do código-fonte
    • Teste automatizado de definições do blueprint em ambientes de teste
    • Suporte dos componentes principais de CI/CD (integração contínua e implantação contínua)

Seja qual for o seu motivo, gerencie suas definições de blueprint como código tem benefícios. Este artigo mostra como usar os comandos Import-AzBlueprintWithArtifact e Export-AzBlueprintWithArtifact no módulo AZ. Blueprint.

Pré-requisitos

Este artigo pressupõe um conhecimento de trabalho moderado do Azure Blueprints. Se você ainda não tiver feito isso, trabalhe nos seguintes artigos:

Se ainda não estiver instalado, siga as instruções em Adicionar o módulo Az.Blueprint para instalar e validar o módulo Az.Blueprint na Galeria do PowerShell.

Estrutura de pastas de uma definição de blueprint

Antes de examinar a exportação e a importação de plantas, vejamos como os arquivos que compõem a definição do blueprint são estruturados. Uma definição de blueprint deve ser armazenada em sua própria pasta.

Importante

Se nenhum valor for passado para o parâmetro Nome do Import-AzBlueprintWithArtifactcmdlet, será usado o nome da pasta em que a definição de blueprint será armazenada.

Juntamente com a definição de blueprint, que deve ser nomeada blueprint.json, estão os artefatos dos quais a definição de blueprint é composta. Cada artefato deve estar na subpasta chamada artifacts. Em conjunto, a estrutura de sua definição de blueprint como arquivos JSON em pastas deve ter a seguinte aparência:

.
|
|- MyBlueprint/  _______________ # Root folder name becomes default name of blueprint definition
|  |- blueprint.json  __________ # The blueprint definition. Fixed name.
|
|  |- artifacts/  ______________ # Subfolder for all blueprint artifacts. Fixed name.
|     |- artifact.json  ________ # Blueprint artifact as JSON file. Artifact named from file.
|     |- ...
|     |- more-artifacts.json

Exportar sua definição de blueprint

As etapas para exportar sua definição de blueprint são simples. Exportar a definição de blueprint pode ser útil para compartilhamento, backup ou colocação no controle do código-fonte.

  • Blueprint [obrigatório]
    • Descreve a definição do Blueprint
    • Use Get-AzBlueprint para obter o objeto de referência
  • OutputPath [obrigatório]
    • Especifica o caminho para salvar os arquivos JSON de definição de blueprint em
    • Os arquivos de saída estão em uma subpasta com o nome da definição de blueprint
  • Versão (opcional)
    • Especifica a versão de saída se o objeto de referência Blueprint contiver referências a mais de uma versão.

  1. Obter uma referência à definição de blueprint a ser exportada da assinatura representada como {subId}:

    # Login first with Connect-AzAccount if not using Cloud Shell

# Get version '1.1' of the blueprint definition in the specified subscription
$bpDefinition = Get-AzBlueprint -SubscriptionId '{subId}' -Name 'MyBlueprint' -Version '1.1'

  2. Use o Export-AzBlueprintWithArtifact cmdlet para exportar a definição de blueprint especificada:

    Export-AzBlueprintWithArtifact -Blueprint $bpDefinition -OutputPath 'C:\Blueprints'

Importar sua definição de blueprint

Depois de ter uma definição de blueprint exportada ou ter uma definição de blueprint criada manualmente na estrutura de pastas necessária, você poderá importar essa definição de blueprint para um grupo de gerenciamento ou assinatura diferente.

Para exemplos de definições de blueprint interno, confira o repositório do GitHub do Azure Blueprints.

  • Nome [obrigatório]
    • Especifica o nome da nova definição de blueprint
  • InputPath [obrigatório]
  • ManagementGroupId (optional)
    • A ID do grupo de gerenciamento para salvar a definição de plano gráfico se não for o padrão de contexto atual
    • ManagementGroupId ou SubscriptionId devem ser especificados
  • SubscriptionId (opcional)
    • A ID da assinatura para salvar a definição do plano gráfico se não for o padrão de contexto atual
    • ManagementGroupId ou SubscriptionId devem ser especificados

  1. Use o Import-AzBlueprintWithArtifact cmdlet para exportar a definição de blueprint especificada:

    # Login first with Connect-AzAccount if not using Cloud Shell

Import-AzBlueprintWithArtifact -Name 'MyBlueprint' -ManagementGroupId 'DevMG' -InputPath 'C:\Blueprints\MyBlueprint'

Depois que a definição do Blueprint for importada, atribua-a com o PowerShell.

Para obter informações sobre como criar definições de blueprint avançadas, consulte os seguintes artigos:

Próximas etapas