Save-AzureRmVMImage
Salva uma máquina virtual como um VMImage.
Aviso
O módulo AzureRM do PowerShell 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 Az PowerShell para garantir suporte e atualizações contínuos.
Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso continuado a critério e risco do usuário. Consulte nossos recursos de migração para obter orientação 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, sysprep a máquina virtual e marque-a como generalizada usando o cmdlet Set-AzureRmVM. 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
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 Job para acompanhar o progresso.
| Tipo: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.
| Tipo: | IAzureContextContainer |
| Aliases: | AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | 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>.
| Tipo: | String |
| Position: | 2 |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-Id
Especifica a ID do Recurso da máquina virtual.
| Tipo: | String |
| Position: | 0 |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-Name
Especifica um nome.
| Tipo: | String |
| Aliases: | VMName |
| Position: | 1 |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-Overwrite
Indica que esse cmdlet substitui qualquer VHDs que tenha o mesmo prefixo no contêiner de destino.
| Tipo: | SwitchParameter |
| Position: | 4 |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-Path
O caminho do arquivo no qual o modelo da imagem capturada é armazenado.
| Tipo: | String |
| Position: | 5 |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-ResourceGroupName
Especifica o nome do grupo de recursos da máquina virtual.
| Tipo: | String |
| Position: | 0 |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | 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 |
| Position: | 3 |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |