Compartilhar via

Add-AzVMDataDisk

Módulo:
Az.Compute Module

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

Sintaxe

VmNormalDiskParameterSetName (Default) 

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>]

VmManagedDiskParameterSetName 

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.

Propriedades do parâmetro

Tipo:CachingTypes
Valor padrão:None
Valores aceitos:None, ReadOnly, ReadWrite
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

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

Propriedades do parâmetro

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

Conjuntos de parâmetros

(All)
Cargo:6
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
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

-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.

Propriedades do parâmetro

Tipo:String
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:True
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:String
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

-DiskSizeInGB

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

Propriedades do parâmetro

Tipo:

Nullable<T>[Int32]

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

-Lun

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

Propriedades do parâmetro

Tipo:

Nullable<T>[Int32]

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

Conjuntos de parâmetros

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

-ManagedDiskId

Especifica a ID de um disco gerenciado.

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-Name

Especifica o nome do disco de dados a ser adicionado.

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-SourceImageUri

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

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-SourceResourceId

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

Propriedades do parâmetro

Tipo:String
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:True
Valor dos argumentos restantes:False

-StorageAccountType

Especifica o tipo de conta de armazenamento do disco gerenciado.

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

Propriedades do parâmetro

Tipo:PSVirtualMachine
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:VMProfile

Conjuntos de parâmetros

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

-WriteAccelerator

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

Propriedades do parâmetro

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

Conjuntos de parâmetros

VmManagedDiskParameterSetName
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
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

PSVirtualMachine

String

CachingTypes

Nullable<T>

Saídas

PSVirtualMachine

PSVirtualMachineScaleSetVM