Add-AzVMDataDisk
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>]
[-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>]
[-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 EmptyIl 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 $VirtualMachineIl 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 FromImageIl 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 AttachIl 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.
| Type: | CachingTypes |
| Accepted values: | None, ReadOnly, ReadWrite |
| Position: | 3 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | 6 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DefaultProfile
Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DiskSizeInGB
Specifica le dimensioni, in gigabyte, di un disco vuoto da collegare a una macchina virtuale.
| Type: | Nullable<T>[Int32] |
| Position: | 4 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Lun
Specifica il numero di unità logica (LUN) per un disco dati.
| Type: | Nullable<T>[Int32] |
| Position: | 5 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ManagedDiskId
Specifica l'ID di un disco gestito.
| Type: | String |
| Position: | 8 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Specifica il nome del disco dati da aggiungere.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SourceImageUri
Specifica l'URI di origine del disco associato da questo cmdlet.
| Type: | String |
| Aliases: | SourceImage |
| Position: | 7 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-StorageAccountType
Specifica il tipo di account di archiviazione del disco gestito.
| Type: | String |
| Position: | 9 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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.
| Type: | PSVirtualMachine |
| Aliases: | VMProfile |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WriteAccelerator
Specifica se WriteAccelerator deve essere abilitato o disabilitato in un disco dati gestito.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Input
Nullable<T>[[System.Int32, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]
Output
Collegamenti correlati
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per