Partilhar via


New-AzureRmVMDataDisk

Cria um objeto de disco de dados local para uma máquina virtual ou 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

New-AzureRmVMDataDisk
   [-Lun] <Int32>
   [-CreateOption] <String>
   [-Name <String>]
   [-Caching <CachingTypes>]
   [-DiskSizeInGB <Int32>]
   [-VhdUri <String>]
   [-SourceImageUri <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzureRmVMDataDisk
   [-Lun] <Int32>
   [-CreateOption] <String>
   [-Name <String>]
   [-Caching <CachingTypes>]
   [-DiskSizeInGB <Int32>]
   [-ManagedDiskId <String>]
   [-StorageAccountType <String>]
   [-WriteAccelerator]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

O cmdlet New-AzureRmVMDataDisk cria um objeto de disco de dados local para uma máquina virtual ou 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:\> $datadisk = New-AzureRmVMDataDisk -Caching 'ReadOnly' -Lun 2 -CreateOption Attach -StorageAccountType Standard_LRS -ManagedDiskId $disk.Id
PS C:\> $VmssVM = Get-AzureRmVmssVM -ResourceGroupName "myrg" -VMScaleSetName "myvmss" -InstanceId 0
PS C:\> Update-AzureRmVmssVM -ResourceGroupName "myrg" -VMScaleSetName "myvmss" -InstanceId 0 -DataDisk $datadisk

O primeiro comando obtém um disco gerenciado existente. O próximo comando cria um objeto de disco de dados com o disco gerenciado. 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 comando final atualiza a VM Vmss adicionando um novo disco de dados.

Parâmetros

-Caching

O cache do disco de dados da máquina virtual.

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

A opção de criação do disco de dados da máquina virtual.

Tipo:String
Position:1
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

O tamanho do disco de dados da máquina virtual em GB.

Tipo:Nullable<T>[Int32]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Lun

O Lun do disco de dados da máquina virtual.

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

-ManagedDiskId

A ID do disco gerenciado pela máquina virtual.

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

-Name

O nome do disco de dados da máquina virtual.

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

-SourceImageUri

Uri da imagem de origem do disco do SO da máquina virtual.

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

-StorageAccountType

O tipo de conta do disco gerenciado pela máquina virtual.

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

-VhdUri

O Vhd Uri do disco de dados da máquina virtual.

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

-WriteAccelerator

Especifica se o WriteAccelerator deve ser habilitado ou desabilitado em um disco de dados gerenciado.

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

Entradas

Int32

String

CachingTypes

Nullable<T>[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Saídas

PSVirtualMachineDataDisk