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