Set-AzVMDataDisk

Modifica le proprietà di un disco dati di una macchina virtuale.

Sintassi

Set-AzVMDataDisk
   [-VM] <PSVirtualMachine>
   [-Name] <String>
   [[-Caching] <CachingTypes>]
   [[-DiskSizeInGB] <Int32>]
   [-StorageAccountType <String>]
   [-DiskEncryptionSetId <String>]
   [-WriteAccelerator]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzVMDataDisk
   [-VM] <PSVirtualMachine>
   [-Lun] <Int32>
   [[-Caching] <CachingTypes>]
   [[-DiskSizeInGB] <Int32>]
   [-StorageAccountType <String>]
   [-DiskEncryptionSetId <String>]
   [-WriteAccelerator]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Descrizione

Il cmdlet Set-AzVMDataDisk modifica le proprietà di un disco dati di una macchina virtuale.

Esempio

Esempio 1: Modificare la modalità di memorizzazione nella cache di un disco dati

$VM = Get-AzVM -ResourceGroupName "ResourceGroup11" -VMName "ContosoVM07"
Set-AzVMDataDisk -VM $VM -Name "DataDisk01" -Caching ReadWrite | Update-AzVM

Il primo comando ottiene la macchina virtuale denominata ContosoVM07 usando Get-AzVM. Il comando lo archivia nella variabile $VM. Il secondo comando modifica la modalità di memorizzazione nella cache per il disco dati denominato DataDisk01 nella macchina virtuale in $VM. Il comando passa il risultato al cmdlet Update-AzVM, che implementa le modifiche. Una modifica alla modalità di cassa determina il riavvio della macchina virtuale.

Esempio 2

Modifica le proprietà di un disco dati di una macchina virtuale. (generato automaticamente)

Set-AzVMDataDisk -Caching None -Lun 1 -VM <PSVirtualMachine>

Parametri

-Caching

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

  • ReadOnly
  • ReadWrite 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:Nullable<T>[CachingTypes]
Valori accettati:None, ReadOnly, ReadWrite
Posizione:2
Valore predefinito:None
Necessario:False
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

-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, per il disco dati.

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

-Lun

Specifica il numero di unità logica (LUN) del disco dati modificato da questo cmdlet.

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

-Name

Specifica il nome del disco dati modificato da questo cmdlet.

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

-StorageAccountType

Tipo di account del disco gestito della macchina virtuale.

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

-VM

Specifica la macchina virtuale per cui questo cmdlet modifica un disco dati. Per ottenere un oggetto macchina virtuale, usare il cmdlet Get-AzVM.

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 nel disco dati.

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

Input

PSVirtualMachine

String

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

Nullable<T>[[Microsoft.Azure.Management.Compute.Models.CachingTypes, Microsoft.Azure.Management.Compute, Version=23.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]

Output

PSVirtualMachine