Compartilhar via

Save-AzVMImage

Módulo:
Az.Compute Module

Salva uma máquina virtual como uma VMImage.

Sintaxe

ResourceGroupNameParameterSetName (Default) 

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

IdParameterSetName 

Save-AzVMImage
    [-DestinationContainerName] <String>
    [-VHDNamePrefix] <String>
    [[-Path] <String>]
    [-Id] <String>
    [-Overwrite]
    [-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. (autogenerated)

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.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DefaultProfile

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

Propriedades do parâmetro

Tipo:IAzureContextContainer
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxx.vhd>.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:2
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Id

Especifica a ID do recurso da máquina virtual.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

IdParameterSetName
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Name

Especifica um nome.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:VMName

Conjuntos de parâmetros

ResourceGroupNameParameterSetName
Cargo:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Overwrite

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:4
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Path

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:5
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ResourceGroupName

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ResourceGroupNameParameterSetName
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes: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>.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:VirtualHardDiskNamePrefix

Conjuntos de parâmetros

(All)
Cargo:3
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

String

SwitchParameter

Saídas

PSComputeLongRunningOperation