Save-AzureRmVMImage
Salva uma máquina virtual como um VMImage.
Aviso
O módulo PowerShell do AzureRM foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo do Az PowerShell para garantir o suporte e as atualizações contínuas.
Embora o módulo AzureRM ainda possa funcionar, ele não tem suporte ou será mantido, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes sobre a transição para o módulo Az.
Sintaxe
Save-AzureRmVMImage
[-Name] <String>
[-DestinationContainerName] <String>
[-VHDNamePrefix] <String>
[-Overwrite]
[[-Path] <String>]
[-ResourceGroupName] <String>
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Save-AzureRmVMImage
[-Name] <String>
[-DestinationContainerName] <String>
[-VHDNamePrefix] <String>
[-Overwrite]
[[-Path] <String>]
[-Id] <String>
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Description
O cmdlet Save-AzureRmVMImage salva uma máquina virtual como um VMImage. Antes de criar uma imagem de máquina virtual, faça sysprep na máquina virtual e marque-a como generalizada usando o cmdlet Set-AzureRmVM. A saída desse 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
PS C:\> Set-AzureRmVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07" -Generalized
PS C:\> Save-AzureRmVMImage -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.
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: | 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 o 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 com 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-xxxxxxxxxxxx.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 do 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 |