Save-AzVMImage

  • Referência
Módulo:
Az.Compute

Salva uma máquina virtual como um VMImage.

Syntax

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 um VMImage. Antes de criar uma imagem de máquina virtual, sysprep a máquina virtual e marque-a como generalizada usando o cmdlet Set-AzVM. A saída deste cmdlet é um modelo JSON (JavaScript Object Notation). Você pode implantar máquinas virtuais a partir 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 um VMImage. A propriedade Output retorna um modelo JSON.

Exemplo 2

Salva uma máquina virtual como um 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 Job para acompanhar o progresso.

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

-DefaultProfile

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

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

-DestinationContainerName

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

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

-Id

Especifica a ID do Recurso da máquina virtual.

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

-Name

Especifica um nome.

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

-Overwrite

Indica que esse cmdlet substitui qualquer VHDs que tenha o mesmo prefixo no contêiner de destino.

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

-Path

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

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

-ResourceGroupName

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

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

-VHDNamePrefix

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

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

Entradas

String

SwitchParameter

Saídas

PSComputeLongRunningOperation