Compartilhar via

Add-AzVMDataDisk

  • Referência
Módulo:
Az.Compute

Adiciona um disco de dados a uma máquina virtual.

Sintaxe

Add-AzVMDataDisk
   [-VM] <PSVirtualMachine>
   [[-Name] <String>]
   [[-VhdUri] <String>]
   [[-Caching] <CachingTypes>]
   [[-DiskSizeInGB] <Int32>]
   [-Lun] <Int32>
   [-CreateOption] <String>
   [[-SourceImageUri] <String>]
   [-DiskEncryptionSetId <String>]
   [-DeleteOption <String>]
   [-SourceResourceId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzVMDataDisk
   [-VM] <PSVirtualMachine>
   [[-Name] <String>]
   [[-Caching] <CachingTypes>]
   [[-DiskSizeInGB] <Int32>]
   [-Lun] <Int32>
   [-CreateOption] <String>
   [[-ManagedDiskId] <String>]
   [[-StorageAccountType] <String>]
   [-DiskEncryptionSetId <String>]
   [-WriteAccelerator]
   [-DeleteOption <String>]
   [-SourceResourceId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

O cmdlet Add-AzVMDataDisk adiciona um disco de dados a uma máquina virtual. Você pode adicionar um disco de dados ao criar uma máquina virtual ou adicionar um disco de dados a uma máquina virtual existente.

Exemplos

Exemplo 1: Adicionar discos de dados a uma nova máquina virtual

$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
$DataDiskVhdUri01 = "https://contoso.blob.core.windows.net/test/data1.vhd"
$DataDiskVhdUri02 = "https://contoso.blob.core.windows.net/test/data2.vhd"
$DataDiskVhdUri03 = "https://contoso.blob.core.windows.net/test/data3.vhd"
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name 'DataDisk1' -Caching 'ReadOnly' -DiskSizeInGB 10 -Lun 0 -VhdUri $DataDiskVhdUri01 -CreateOption Empty
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name 'DataDisk2' -Caching 'ReadOnly' -DiskSizeInGB 11 -Lun 1 -VhdUri $DataDiskVhdUri02 -CreateOption Empty
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name 'DataDisk3' -Caching 'ReadOnly' -DiskSizeInGB 12 -Lun 2 -VhdUri $DataDiskVhdUri03 -CreateOption Empty

O primeiro comando cria um objeto de máquina virtual e o armazena na variável $VirtualMachine. O comando atribui um nome e um tamanho à máquina virtual. Os três comandos seguintes atribuem caminhos de três discos de dados às variáveis $DataDiskVhdUri 01, $DataDiskVhdUri 02 e $DataDiskVhdUri 03. Essa abordagem destina-se apenas à legibilidade dos comandos a seguir. Os três comandos finais adicionam um disco de dados à máquina virtual armazenada em $VirtualMachine. O comando especifica o nome e o local do disco e outras propriedades do disco. O URI de cada disco é armazenado em $DataDiskVhdUri 01, $DataDiskVhdUri 02 e $DataDiskVhdUri 03.

Exemplo 2: Adicionar um disco de dados a uma máquina virtual existente

$VirtualMachine = Get-AzVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07"
Add-AzVMDataDisk -VM $VirtualMachine -Name "disk1" -VhdUri "https://contoso.blob.core.windows.net/vhds/diskstandard03.vhd" -LUN 0 -Caching ReadOnly -DiskSizeinGB 1 -CreateOption Empty
Update-AzVM -ResourceGroupName "ResourceGroup11" -VM $VirtualMachine

O primeiro comando obtém a máquina virtual chamada VirtualMachine07 usando o cmdlet Get-AzVM . O comando armazena a máquina virtual na variável $VirtualMachine. O segundo comando adiciona um disco de dados à máquina virtual armazenada em $VirtualMachine. O comando final atualiza o estado da máquina virtual armazenada em $VirtualMachine no ResourceGroup11.

Exemplo 3: Adicionar um disco de dados a uma nova máquina virtual de uma imagem de usuário generalizada

$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
$DataImageUri = "https://contoso.blob.core.windows.net/system/Microsoft.Compute/Images/captured/dataimage.vhd"
$DataDiskUri = "https://contoso.blob.core.windows.net/test/datadisk.vhd"
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name "disk1" -SourceImageUri $DataImageUri -VhdUri $DataDiskUri -Lun 0 -DiskSizeinGB 10 -CreateOption FromImage

O primeiro comando cria um objeto de máquina virtual e o armazena na variável $VirtualMachine. O comando atribui um nome e um tamanho à máquina virtual. Os dois comandos seguintes atribuem caminhos para a imagem de dados e discos de dados às variáveis $DataImageUri e $DataDiskUri respectivamente. Essa abordagem é usada para melhorar a legibilidade dos comandos a seguir. Os comandos finais adicionam um disco de dados à máquina virtual armazenada em $VirtualMachine. O comando especifica o nome e o local do disco e outras propriedades do disco.

Exemplo 4: Adicionar discos de dados a uma nova máquina virtual de uma imagem de usuário especializada

$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
$DataDiskUri = "https://contoso.blob.core.windows.net/test/datadisk.vhd"
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name "dd1" -VhdUri $DataDiskUri -Lun 0 -DiskSizeinGB 10 -CreateOption Attach

O primeiro comando cria um objeto de máquina virtual e o armazena na variável $VirtualMachine. O comando atribui um nome e um tamanho à máquina virtual. Os comandos seguintes atribuim caminhos do disco de dados à variável $DataDiskUri. Essa abordagem é usada para melhorar a legibilidade dos comandos a seguir. O comando final adiciona um disco de dados à máquina virtual armazenada em $VirtualMachine. O comando especifica o nome e o local do disco e outras propriedades do disco.

Parâmetros

-Caching

Especifica o modo de cache do disco. Os valores aceitáveis para este parâmetro são:

  • ReadOnly
  • ReadWrite
  • Nenhum O valor padrão é ReadWrite. Alterar esse valor faz com que a máquina virtual seja reiniciada. Essa configuração afeta a consistência e o desempenho do disco.
Tipo:CachingTypes
Valores aceitos:None, ReadOnly, ReadWrite
Cargo:3
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-CreateOption

Especifica se esse cmdlet cria um disco na máquina virtual de uma plataforma ou imagem de usuário, cria um disco vazio ou anexa um disco existente. Os valores aceitáveis para este parâmetro são:

  • Anexar. Especifique essa opção para criar uma máquina virtual de um disco especializado. Ao especificar essa opção, não especifique o parâmetro SourceImageUri. O VhdUri é tudo o que é necessário para informar à plataforma do Azure o local do VHD (disco rígido virtual) a ser anexado como um disco de dados à máquina virtual.
  • Vazio. Especifique isso para criar um disco de dados vazio.
  • FromImage. Especifique essa opção para criar uma máquina virtual a partir de uma imagem ou disco generalizado. Ao especificar essa opção, você deve especificar o parâmetro SourceImageUri também para informar à plataforma do Azure o local do VHD a ser anexado como um disco de dados. O parâmetro VhdUri é usado como o local que identifica onde o VHD do disco de dados será armazenado quando ele for usado pela máquina virtual.
  • Vazio. Esse valor é usado ao criar um disco de dados vazio.
  • Copiar. Esse valor é usado para criar um disco de dados de um instantâneo ou outro disco. Restauração: Esse valor é usado para criar um disco de dados a partir de um ponto de restauração de disco.
Tipo:String
Cargo:6
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
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

-DeleteOption

Opção de Exclusão de Disco de Dados. Especifica qual ação executar no disco após a exclusão da VM. As opções são: Desanexar, Excluir.

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

-DiskEncryptionSetId

Especifica a ID do recurso do conjunto de criptografia de disco gerenciado pelo cliente. Isso só pode ser especificado para o disco gerenciado.

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

-DiskSizeInGB

Especifica o tamanho, em gigabytes, de um disco vazio a ser anexado a uma máquina virtual.

Tipo:Nullable<T>[Int32]
Cargo:4
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Lun

Especifica o LUN (número de unidade lógica) para um disco de dados.

Tipo:Nullable<T>[Int32]
Cargo:5
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ManagedDiskId

Especifica a ID de um disco gerenciado.

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

-Name

Especifica o nome do disco de dados a ser adicionado.

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

-SourceImageUri

Especifica o URI de origem do disco que este cmdlet anexa.

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

-SourceResourceId

ID do ARM do ponto de restauração de instantâneo ou disco do qual criar um disco.

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

-StorageAccountType

Especifica o tipo de conta de armazenamento do disco gerenciado.

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

-VhdUri

Especifica o URI (Uniform Resource Identifier) para o arquivo VHD (disco rígido virtual) a ser criado quando uma imagem de plataforma ou imagem de usuário é usada. Esse cmdlet copia o objeto binário grande (blob) da imagem para esse local. Esse é o local do qual iniciar a máquina virtual.

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

-VM

Especifica o objeto da máquina virtual local ao qual adicionar um disco de dados. Você pode usar o cmdlet Get-AzVM para obter um objeto de máquina virtual. Você pode usar o cmdlet New-AzVMConfig para criar um objeto de máquina virtual.

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

-WriteAccelerator

Especifica se WriteAccelerator deve ser habilitado ou desabilitado em um disco de dados gerenciado.

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

Entradas

PSVirtualMachine

String

CachingTypes

Nullable<T>[[System.Int32, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

Saídas

PSVirtualMachine

PSVirtualMachineScaleSetVM