Add-AzureDataDisk

  • Referência
Módulo:
Azure

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

Observação

Os cmdlets mencionados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo herdado do PowerShell não é recomendado ao criar novos recursos, já que o ASM está programado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.

O módulo Az PowerShell é o módulo do PowerShell recomendado para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.

Sintaxe

Add-AzureDataDisk
   [-CreateNew]
   [-DiskSizeInGB] <Int32>
   [-DiskLabel] <String>
   [-LUN] <Int32>
   [-MediaLocation <String>]
   [-HostCaching <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Add-AzureDataDisk
   [-Import]
   [-DiskName] <String>
   [-LUN] <Int32>
   [-HostCaching <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Add-AzureDataDisk
   [-ImportFrom]
   [-DiskLabel] <String>
   [-LUN] <Int32>
   -MediaLocation <String>
   [-HostCaching <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

O cmdlet Add-AzureDataDisk adiciona um disco de dados novo ou existente a um objeto de máquina virtual do Azure. Use o parâmetro CreateNew para criar um novo disco de dados que tenha um tamanho e rótulo especificados. Use o parâmetro Import para anexar um disco existente do repositório de imagens. Use o parâmetro ImportFrom para anexar um disco existente de um blob em uma conta de armazenamento. Você pode especificar o modo de cache do host do disco de dados anexado.

Exemplos

Exemplo 1: Importar um disco de dados do repositório

PS C:\> Get-AzureVM "ContosoService" -Name "VirtualMachine07" | Add-AzureDataDisk -Import -DiskName "Disk68" -LUN 0 | Update-AzureVM

Esse comando obtém um objeto de máquina virtual para a máquina virtual chamada VirtualMachine07 no serviço de nuvem ContosoService usando o cmdlet Get-AzureVM . O comando passa para o cmdlet atual usando o operador de pipeline. Esse comando anexa um disco de dados existente do repositório à máquina virtual. O disco de dados tem um LUN de 0. O comando atualiza a máquina virtual para refletir suas alterações usando o cmdlet Update-AzureVM .

Exemplo 2: Adicionar um novo disco de dados

PS C:\> Get-AzureVM "ContosoService" -Name "VirtualMachine08" | Add-AzureDataDisk -CreateNew -DiskSizeInGB 128 -DiskLabel "main" -LUN 0 | Update-AzureVM

Esse comando obtém um objeto de máquina virtual para a máquina virtual chamada VirtualMachine08. O comando passa para o cmdlet atual. Esse comando anexa um novo disco de dados chamado MyNewDisk.vhd. O cmdlet cria o disco no contêiner vhds na conta de armazenamento padrão da assinatura atual. O comando atualiza a máquina virtual para refletir suas alterações.

Exemplo 3: Adicionar um disco de dados de um local especificado

PS C:\> Get-AzureVM "ContosoService" -Name "Database" | Add-AzureDataDisk -ImportFrom -MediaLocation "https://contosostorage.blob.core.windows.net/container07/Disk14.vhd" -DiskLabel "main" -LUN 0 | Update-AzureVM

Esse comando obtém um objeto de máquina virtual para a máquina virtual chamado Banco de Dados. O comando passa para o cmdlet atual. Esse comando anexa um disco de dados existente chamado Disk14.vhd do local especificado. O comando atualiza a máquina virtual para refletir suas alterações.

Parâmetros

-CreateNew

Indica que esse cmdlet cria um disco de dados.

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

-DiskLabel

Especifica o rótulo do disco para um novo disco de dados.

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

-DiskName

Especifica o nome de um disco de dados no repositório de discos.

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

-DiskSizeInGB

Especifica o tamanho do disco lógico, em gigabytes, para um novo disco de dados.

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

-HostCaching

Especifica as configurações de cache no nível do host do disco. Os valores válidos são:

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

-Import

Indica que esse cmdlet importa um disco de dados existente do repositório de imagens.

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

-ImportFrom

Indica que esse cmdlet importa um disco de dados existente de um blob em uma conta de armazenamento.

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

-InformationAction

Especifica como esse cmdlet responde a um evento de informações.

Os valores aceitáveis para esse parâmetro são:

  • Continuar
  • Ignorar
  • Perguntar
  • SilentlyContinue
  • Parar
  • Suspend
Tipo:ActionPreference
Aliases:infa
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InformationVariable

Especifica uma variável de informação.

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

-LUN

Especifica o número de unidade lógica (LUN) para a unidade de dados na máquina virtual. Os valores válidos são: 0 a 15. Cada disco de dados deve ter um LUN exclusivo.

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

-MediaLocation

Especifica o local do blob em uma conta de armazenamento do Azure onde esse cmdlet armazena o disco de dados. Se você não especificar um local, o cmdlet armazenará o disco de dados no contêiner vhds na conta de armazenamento padrão da assinatura atual. Se um contêiner vhds não existir, o cmdlet criará um contêiner vhds.

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

-Profile

Especifica o perfil do Azure a partir do qual este cmdlet lê. Se você não especificar um perfil, esse cmdlet será lido a partir do perfil padrão local.

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

-VM

Especifica o objeto de máquina virtual ao qual esse cmdlet anexa um disco de dados. Para obter um objeto de máquina virtual, use o cmdlet Get-AzureVM .

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