Compartilhar via

Save-AzVMImage

  • Referência
Módulo:
Az.Compute

Salva uma máquina virtual como uma VMImage.

Sintaxe

Save-AzVMImage
    [-Name] <String>
    [-DestinationContainerName] <String>
    [-VHDNamePrefix] <String>
    [-Overwrite]
    [[-Path] <String>]
    [-ResourceGroupName] <String>
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]
Save-AzVMImage
    [-DestinationContainerName] <String>
    [-VHDNamePrefix] <String>
    [-Overwrite]
    [[-Path] <String>]
    [-Id] <String>
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Description

O cmdlet Save-AzVMImage salva uma máquina virtual como uma VMImage. Antes de criar uma imagem de máquina virtual, pretera a máquina virtual e marque-a como generalizada usando o cmdlet Set-AzVM. A saída desse cmdlet é um modelo JSON (JavaScript Object Notation). Você pode implantar máquinas virtuais da imagem capturada.

Exemplos

Exemplo 1: capturar uma máquina virtual

Set-AzVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07" -Generalized 
Save-AzVMImage -ResourceGroupName "ResourceGroup11" -VMName "VirtualMachine07" -DestinationContainerName "VMContainer01" -VHDNamePrefix "VM07"

O primeiro comando marca a máquina virtual chamada VirtualMachine07 como generalizada. O segundo comando captura uma máquina virtual chamada VirtualMachine07 como uma VMImage. A propriedade Output retorna um modelo JSON.

Exemplo 2

Salva uma máquina virtual como uma VMImage. (gerado automaticamente)

Save-AzVMImage -DestinationContainerName 'VMContainer01' -Name 'VirtualMachine07' -Path '/home/admin/.ssh/authorized_keys' -ResourceGroupName 'ResourceGroup11' -VHDNamePrefix 'VM07'

Parâmetros

-AsJob

Execute o cmdlet em segundo plano e retorne um trabalho para acompanhar o progresso.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DestinationContainerName

Especifica o nome de um contêiner dentro do contêiner "sistema" que você deseja manter suas imagens. Se o contêiner não existir, ele será criado para você. Os VHDs (discos rígidos virtuais) que constituem a VMImage residem no contêiner especificado por esse parâmetro. Se os VHDs estiverem distribuídos em várias contas de armazenamento, esse cmdlet criará um contêiner que tenha esse nome em cada conta de armazenamento. A URL da imagem salva é semelhante a: https://<storageAccountName>.blob.core.windows.net/system/Microsoft.Compute/Images/<imagesContainer>/<vhdPrefix-osDisk>.xxxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.VHD.

Tipo:String
Cargo:2
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Id

Especifica a ID do recurso da máquina virtual.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Name

Especifica um nome.

Tipo:String
Aliases:VMName
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Overwrite

Indica que esse cmdlet substitui todos os VHDs que têm o mesmo prefixo no contêiner de destino.

Tipo:SwitchParameter
Cargo:4
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Path

O caminho do arquivo no qual o modelo da imagem capturada é armazenado.

Tipo:String
Cargo:5
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ResourceGroupName

Especifica o nome do grupo de recursos da máquina virtual.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-VHDNamePrefix

Especifica o prefixo no nome dos blobs que constituem o perfil de armazenamento da VMImage. Por exemplo, um prefixo vhdPrefix para um disco do sistema operacional resulta no nome vhdPrefix-osdisk.<guid>.vhd.

Tipo:String
Aliases:VirtualHardDiskNamePrefix
Cargo:3
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Entradas

String

SwitchParameter

Saídas

PSComputeLongRunningOperation