Add-AzureDataDisk

Referência

Módulo:: Azure

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

Observação

Os cmdlets mostrados nesta documentação são usados para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Confira o módulo Az PowerShell para usar cmdlets a fim de gerenciar recursos do Azure Resource Manager.

Syntax

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.

Type:	SwitchParameter
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DiskLabel

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

Type:	String
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DiskName

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

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-DiskSizeInGB

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

Type:	Int32
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-HostCaching

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

Nenhum
ReadOnly
ReadWrite

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Import

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

Type:	SwitchParameter
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ImportFrom

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

Type:	SwitchParameter
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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
Stop
Suspend

Type:	ActionPreference
Aliases:	infa
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InformationVariable

Especifica uma variável de informação.

Type:	String
Aliases:	iv
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Int32
Position:	3
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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.

Type:	AzureSMProfile
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 .

Type:	IPersistentVM
Aliases:	InputObject
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False