Partilhar via

Add-AzureDataDisk

  • Referência
Módulo:
Azure

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

Nota

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 do PowerShell herdado não é recomendado ao criar novos recursos, uma vez que o ASM está agendado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.

O módulo Az PowerShell é o módulo 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

Este 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

Este comando obtém um objeto de máquina virtual para a máquina virtual chamada VirtualMachine08. O comando o 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

Este comando obtém um objeto de máquina virtual para a máquina virtual chamado Banco de Dados. O comando o 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
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DiskLabel

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

Tipo:String
Position:2
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DiskName

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

Tipo:String
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-DiskSizeInGB

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

Tipo:Int32
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-HostCaching

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

  • Nenhuma
  • ReadOnly
  • ReadWrite
Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Import

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

Tipo:SwitchParameter
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ImportFrom

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

Tipo:SwitchParameter
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-InformationAction

Especifica como esse cmdlet responde a um evento de informação.

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

  • Continuar
  • Ignorar
  • Informe-se
  • SilenciosamenteContinue
  • Parar
  • Suspender
Tipo:ActionPreference
Aliases:infa
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-InformationVariable

Especifica uma variável de informação.

Tipo:String
Aliases:iv
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-LUN

Especifica o número da 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
Position:3
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais: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 para a assinatura atual. Se um contêiner vhds não existir, o cmdlet criará um contêiner vhds.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Profile

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

Tipo:AzureSMProfile
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-VM

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

Tipo:IPersistentVM
Aliases:InputObject
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False