Compartilhar via


Add-AzVMDataDisk

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>]
   [-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>]
   [-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 pode 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, em seguida, o armazena na variável $VirtualMachine. O comando atribui um nome e tamanho à máquina virtual. Os próximos três comandos atribuem caminhos de três discos de dados às variáveis $DataDiskVhdUri 01, $DataDiskVhdUri 02 e $DataDiskVhdUri 03. Essa abordagem é apenas para legibilidade dos comandos a seguir. Cada um dos três comandos finais 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. 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 no $VirtualMachine. O comando final atualiza o estado da máquina virtual armazenada no $VirtualMachine em ResourceGroup11.

Exemplo 3: Adicionar um disco de dados a uma nova máquina virtual a partir 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 tamanho à máquina virtual. Os próximos dois comandos atribuem caminhos para a imagem de dados e os discos de dados para as 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 a partir 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 tamanho à máquina virtual. Os próximos comandos atribuem 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 esse parâmetro são:

  • ReadOnly (somente-leitura)
  • 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 a partir de uma plataforma ou imagem de usuário, cria um disco vazio ou anexa um disco existente. Os valores aceitáveis para esse parâmetro são:

  • Anexar. Especifique essa opção para criar uma máquina virtual a partir 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ê também deve especificar o parâmetro SourceImageUri 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 for usado pela máquina virtual.
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) de 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 esse 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

-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 blob (objeto binário grande) de imagem para esse local. Este é o local a partir 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 de 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 o 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