Add-AzureRmVmssVMDataDisk

Referência

Módulo:: AzureRM.Compute

Adiciona um disco de dados a uma VM Vmss.

Aviso

O módulo AzureRM do PowerShell foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo Az PowerShell para garantir suporte e atualizações contínuos.

Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso continuado a critério e risco do usuário. Consulte nossos recursos de migração para obter orientação sobre a transição para o módulo Az.

Sintaxe

Add-AzureRmVmssVMDataDisk
   [-VirtualMachineScaleSetVM] <PSVirtualMachineScaleSetVM>
   [-Lun] <Int32>
   [-CreateOption] <String>
   [-ManagedDiskId] <String>
   [-StorageAccountType <String>]
   [-Caching <CachingTypes>]
   [-DiskSizeInGB <Int32>]
   [-WriteAccelerator]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

O cmdlet Add-AzureRmVmssVMDataDisk adiciona um disco de dados a uma VM Vmss.

Exemplos

Exemplo 1: Adicionar um disco de dados gerenciado a uma VM Vmss.

PS C:\> $disk = Get-AzureRmDisk -ResourceGroupName $rgname -DiskName $diskname0
PS C:\> $VmssVM = Get-AzureRmVmssVM -ResourceGroupName "myrg" -VMScaleSetName "myvmss" -InstanceId 0
PS C:\> $VmssVM = Add-AzureRmVmssVMDataDisk -VirtualMachineScaleSetVM $VmssVM -Lun 0 -DiskSizeInGB 10 -CreateOption Attach -StorageAccountType Standard_LRS -ManagedDiskId $disk.Id
PS C:\> Update-AzureRmVmssVM -VirtualMachineScaleSetVM $VmssVM

O primeiro comando obtém um disco gerenciado existente. O próximo comando obtém uma VM Vmss existente fornecida pelo nome do grupo de recursos, o nome vmss e o ID da instância. O próximo comando adiciona o disco gerenciado à VM Vmss armazenada localmente no $VmssVM. O comando final atualiza a VM Vmss com disco de dados adicionado.

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.

Tipo:	CachingTypes
Valores aceites:	None, ReadOnly, ReadWrite
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	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 este parâmetro são:

Anexar. Especifique esta 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 Azure o local do disco rígido virtual (VHD) a ser anexado como um disco de dados à máquina virtual.
Vazio. Especifique isso para criar um disco de dados vazio.
FromImage. Especifique esta 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 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
Position:	2
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Tipo:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-DiskSizeInGB

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

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

-Lun

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

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

-ManagedDiskId

Especifica a ID de um disco gerenciado.

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

-StorageAccountType

Especifica o tipo de conta de armazenamento do disco gerenciado.

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

-VirtualMachineScaleSetVM

Especifica o objeto VM do conjunto de escala da máquina virtual local ao qual adicionar um disco de dados. Você pode usar o cmdlet Get-AzureRmVmssVM para obter um objeto VM de conjunto de escala de máquina virtual.