Condividi tramite

Add-AzVMDataDisk

Modulo:
Az.Compute Module

Aggiunge un disco dati a una macchina virtuale.

Sintassi

VmNormalDiskParameterSetName (impostazione predefinita). 

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>]

VmManagedDiskParameterSetName 

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 accettabili per questo parametro sono:

  • Sola lettura
  • LeggiScrivi
  • 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.

Proprietà dei parametri

Tipo:CachingTypes
Valore predefinito:None
Valori accettati:None, ReadOnly, ReadWrite
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:3
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti: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 accettabili 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.
  • Copiare. Questo valore viene usato per creare un disco dati da uno snapshot o da un altro disco. Restore: Questo valore viene usato per creare un disco dati da un punto di ripristino del disco.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:6
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-DefaultProfile

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

Proprietà dei parametri

Tipo:IAzureContextContainer
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DiskSizeInGB

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

Proprietà dei parametri

Tipo:

Nullable<T>[Int32]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:4
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Lun

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

Proprietà dei parametri

Tipo:

Nullable<T>[Int32]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:5
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-ManagedDiskId

Specifica l'ID di un disco gestito.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

VmManagedDiskParameterSetName
Posizione:8
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Name

Specifica il nome del disco dati da aggiungere.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:1
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-SourceImageUri

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:SourceImage

Set di parametri

VmNormalDiskParameterSetName
Posizione:7
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-SourceResourceId

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-StorageAccountType

Specifica il tipo di account di archiviazione del disco gestito.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

VmManagedDiskParameterSetName
Posizione:9
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

VmNormalDiskParameterSetName
Posizione:2
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:PSVirtualMachine
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:VMProfile

Set di parametri

(All)
Posizione:0
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-WriteAccelerator

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

VmManagedDiskParameterSetName
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

PSVirtualMachine

String

CachingTypes

Nullable<T>

Output

PSVirtualMachine

PSVirtualMachineScaleSetVM