Add-AzVMDataDisk

  • Riferimento
Modulo:
Az.Compute

Aggiunge un disco dati a una macchina virtuale.

Sintassi

Add-AzVMDataDisk
   [-VM] <PSVirtualMachine>
   [[-Name] <String>]
   [[-VhdUri] <String>]
   [[-Caching] <CachingTypes>]
   [[-DiskSizeInGB] <Int32>]
   [-Lun] <Int32>
   [-CreateOption] <String>
   [[-SourceImageUri] <String>]
   [-DiskEncryptionSetId <String>]
   [-DeleteOption <String>]
   [-SourceResourceId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzVMDataDisk
   [-VM] <PSVirtualMachine>
   [[-Name] <String>]
   [[-Caching] <CachingTypes>]
   [[-DiskSizeInGB] <Int32>]
   [-Lun] <Int32>
   [-CreateOption] <String>
   [[-ManagedDiskId] <String>]
   [[-StorageAccountType] <String>]
   [-DiskEncryptionSetId <String>]
   [-WriteAccelerator]
   [-DeleteOption <String>]
   [-SourceResourceId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Descrizione

Il cmdlet Add-AzVMDataDisk aggiunge un disco dati a una macchina virtuale. È possibile aggiungere un disco dati quando si crea una macchina virtuale oppure è possibile aggiungere un disco dati a una macchina virtuale esistente.

Esempio

Esempio 1: Aggiungere dischi dati a una nuova macchina virtuale

$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
$DataDiskVhdUri01 = "https://contoso.blob.core.windows.net/test/data1.vhd"
$DataDiskVhdUri02 = "https://contoso.blob.core.windows.net/test/data2.vhd"
$DataDiskVhdUri03 = "https://contoso.blob.core.windows.net/test/data3.vhd"
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name 'DataDisk1' -Caching 'ReadOnly' -DiskSizeInGB 10 -Lun 0 -VhdUri $DataDiskVhdUri01 -CreateOption Empty
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name 'DataDisk2' -Caching 'ReadOnly' -DiskSizeInGB 11 -Lun 1 -VhdUri $DataDiskVhdUri02 -CreateOption Empty
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name 'DataDisk3' -Caching 'ReadOnly' -DiskSizeInGB 12 -Lun 2 -VhdUri $DataDiskVhdUri03 -CreateOption Empty

Il primo comando crea un oggetto macchina virtuale e quindi lo archivia nella variabile $VirtualMachine. Il comando assegna un nome e una dimensione alla macchina virtuale. I tre comandi successivi assegnano i percorsi di tre dischi dati alle variabili $DataDiskVhdUri 01, $DataDiskVhdUri 02 e $DataDiskVhdUri 03. Questo approccio è solo per la leggibilità dei comandi seguenti. I tre comandi finali aggiungono un disco dati alla macchina virtuale archiviata in $VirtualMachine. Il comando specifica il nome e il percorso per il disco e altre proprietà del disco. L'URI di ogni disco viene archiviato in $DataDiskVhdUri 01, $DataDiskVhdUri 02 e $DataDiskVhdUri 03.

Esempio 2: Aggiungere un disco dati a una macchina virtuale esistente

$VirtualMachine = Get-AzVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07"
Add-AzVMDataDisk -VM $VirtualMachine -Name "disk1" -VhdUri "https://contoso.blob.core.windows.net/vhds/diskstandard03.vhd" -LUN 0 -Caching ReadOnly -DiskSizeinGB 1 -CreateOption Empty
Update-AzVM -ResourceGroupName "ResourceGroup11" -VM $VirtualMachine

Il primo comando ottiene la macchina virtuale denominata VirtualMachine07 usando il cmdlet Get-AzVM . Il comando archivia la macchina virtuale nella variabile $VirtualMachine . Il secondo comando aggiunge un disco dati alla macchina virtuale archiviata in $VirtualMachine. Il comando finale aggiorna lo stato della macchina virtuale archiviata in $VirtualMachine in ResourceGroup11.

Esempio 3: Aggiungere un disco dati a una nuova macchina virtuale da un'immagine utente generalizzata

$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
$DataImageUri = "https://contoso.blob.core.windows.net/system/Microsoft.Compute/Images/captured/dataimage.vhd"
$DataDiskUri = "https://contoso.blob.core.windows.net/test/datadisk.vhd"
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name "disk1" -SourceImageUri $DataImageUri -VhdUri $DataDiskUri -Lun 0 -DiskSizeinGB 10 -CreateOption FromImage

Il primo comando crea un oggetto macchina virtuale e lo archivia nella variabile $VirtualMachine. Il comando assegna un nome e una dimensione alla macchina virtuale. I due comandi successivi assegnano i percorsi per l'immagine dati e i dischi dati rispettivamente alle variabili $DataImageUri e $DataDiskUri. Questo approccio viene usato per migliorare la leggibilità dei comandi seguenti. I comandi finali aggiungono un disco dati alla macchina virtuale archiviata in $VirtualMachine. Il comando specifica il nome e il percorso per il disco e altre proprietà del disco.

Esempio 4: Aggiungere dischi dati a una nuova macchina virtuale da un'immagine utente specializzata

$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
$DataDiskUri = "https://contoso.blob.core.windows.net/test/datadisk.vhd"
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name "dd1" -VhdUri $DataDiskUri -Lun 0 -DiskSizeinGB 10 -CreateOption Attach

Il primo comando crea un oggetto macchina virtuale e lo archivia nella variabile $VirtualMachine. Il comando assegna un nome e una dimensione alla macchina virtuale. I comandi successivi assegnano i percorsi del disco dati alla variabile $DataDiskUri. Questo approccio viene usato per migliorare la leggibilità dei comandi seguenti. Il comando finale aggiunge un disco dati alla macchina virtuale archiviata in $VirtualMachine. Il comando specifica il nome e il percorso per il disco e altre proprietà del disco.

Parametri

-Caching

Specifica la modalità di memorizzazione nella cache del disco. I valori validi per questo parametro sono:

  • ReadOnly
  • ReadWrite
  • Nessuno Il valore predefinito è ReadWrite. La modifica di questo valore determina il riavvio della macchina virtuale. Questa impostazione influisce sulla coerenza e sulle prestazioni del disco.
Tipo:CachingTypes
Valori accettati:None, ReadOnly, ReadWrite
Posizione:3
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-CreateOption

Specifica se questo cmdlet crea un disco nella macchina virtuale da una piattaforma o un'immagine utente, crea un disco vuoto o collega un disco esistente. I valori validi per questo parametro sono:

  • Allegare. Specificare questa opzione per creare una macchina virtuale da un disco specializzato. Quando si specifica questa opzione, non specificare il parametro SourceImageUri . Il VhdUri è tutto ciò che è necessario per indicare alla piattaforma Azure la posizione del disco rigido virtuale (VHD) da collegare come disco dati alla macchina virtuale.
  • Vuoto. Specificare questa opzione per creare un disco dati vuoto.
  • FromImage. Specificare questa opzione per creare una macchina virtuale da un'immagine o un disco generalizzato. Quando si specifica questa opzione, è necessario specificare anche il parametro SourceImageUri per indicare alla piattaforma Azure il percorso del disco rigido virtuale da collegare come disco dati. Il parametro VhdUri viene usato come percorso che identifica dove verrà archiviato il disco rigido virtuale del disco dati quando viene usato dalla macchina virtuale.
  • Vuoto. Questo valore viene usato durante la creazione di un disco dati vuoto.
  • Copia. Questo valore viene usato per creare un disco dati da uno snapshot o da un altro disco. Ripristino: questo valore viene usato per creare un disco dati da un punto di ripristino del disco.
Tipo:String
Posizione:6
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DeleteOption

Opzione di eliminazione del disco dati. Specifica l'azione da eseguire sul disco dopo l'eliminazione della macchina virtuale. Le opzioni sono: Scollegamento, Eliminazione.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-DiskEncryptionSetId

Specifica l'ID risorsa del set di crittografia del disco gestito dal cliente. Questa opzione può essere specificata solo per il disco gestito.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DiskSizeInGB

Specifica le dimensioni, in gigabyte, di un disco vuoto da collegare a una macchina virtuale.

Tipo:Nullable<T>[Int32]
Posizione:4
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Lun

Specifica il numero di unità logica (LUN) per un disco dati.

Tipo:Nullable<T>[Int32]
Posizione:5
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ManagedDiskId

Specifica l'ID di un disco gestito.

Tipo:String
Posizione:8
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Specifica il nome del disco dati da aggiungere.

Tipo:String
Posizione:1
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-SourceImageUri

Specifica l'URI di origine del disco associato da questo cmdlet.

Tipo:String
Alias:SourceImage
Posizione:7
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-SourceResourceId

ID ARM del punto di ripristino dello snapshot o del disco da cui creare un disco.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-StorageAccountType

Specifica il tipo di account di archiviazione del disco gestito.

Tipo:String
Posizione:9
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-VhdUri

Specifica l'URI (Uniform Resource Identifier) per il file del disco rigido virtuale da creare quando viene usata un'immagine della piattaforma o un'immagine utente. Questo cmdlet copia l'oggetto binario immagine di grandi dimensioni (BLOB) in questo percorso. Si tratta del percorso da cui avviare la macchina virtuale.

Tipo:String
Posizione:2
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-VM

Specifica l'oggetto macchina virtuale locale a cui aggiungere un disco dati. È possibile usare il cmdlet Get-AzVM per ottenere un oggetto macchina virtuale. È possibile usare il cmdlet New-AzVMConfig per creare un oggetto macchina virtuale.

Tipo:PSVirtualMachine
Alias:VMProfile
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WriteAccelerator

Specifica se WriteAccelerator deve essere abilitato o disabilitato in un disco dati gestito.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

PSVirtualMachine

String

CachingTypes

Nullable<T>[[System.Int32, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

Output

PSVirtualMachine

PSVirtualMachineScaleSetVM