Set-AzVMDataDisk

Ändert die Eigenschaften eines Datenträgers eines virtuellen Computers.

Syntax

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

Beschreibung

Mit dem Cmdlet "Set-AzVMDataDisk " werden die Eigenschaften eines Datenträgers eines virtuellen Computers geändert.

Beispiele

Beispiel 1: Ändern des Cachemodus eines Datenträgers

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

Der erste Befehl ruft den virtuellen Computer ContosoVM07 mithilfe von Get-AzVM ab. Der Befehl speichert sie in der variablen $VM. Mit dem zweiten Befehl wird der Cachemodus für den Datenträger "DataDisk01" auf dem virtuellen Computer in $VM geändert. Der Befehl übergibt das Ergebnis an das Cmdlet Update-AzVM, das Ihre Änderungen implementiert. Eine Änderung des Bargeldmodus bewirkt, dass der virtuelle Computer neu gestartet wird.

Beispiel 2

Ändert die Eigenschaften eines Datenträgers eines virtuellen Computers. (automatisch generiert)

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

Parameter

-Caching

Gibt den Cachemodus des Datenträgers an. Zulässige Werte für diesen Parameter:

  • ReadOnly
  • ReadWrite Der Standardwert ist ReadWrite. Wenn Sie diesen Wert ändern, wird der virtuelle Computer neu gestartet. Diese Einstellung wirkt sich auf die Konsistenz und Leistung des Datenträgers aus.
Type:Nullable<T>[CachingTypes]
Accepted values:None, ReadOnly, ReadWrite
Position:2
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DiskEncryptionSetId

Gibt die Ressourcen-ID des vom Kunden verwalteten Datenträgerverschlüsselungssatzes an. Dies kann nur für verwaltete Datenträger angegeben werden.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DiskSizeInGB

Gibt die Größe des Datenträgers in Gigabyte an.

Type:Nullable<T>[Int32]
Position:3
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Lun

Gibt die logische Einheitennummer (LUN) des Datenträgers an, den dieses Cmdlet ändert.

Type:Nullable<T>[Int32]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Gibt den Namen des Datenträgers an, den dieses Cmdlet ändert.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-StorageAccountType

Der Kontotyp des virtuellen Computers, der vom virtuellen Computer verwaltet wird.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-VM

Gibt den virtuellen Computer an, für den dieses Cmdlet einen Datenträger ändert. Verwenden Sie das Cmdlet "Get-AzVM", um ein Objekt eines virtuellen Computers abzurufen.

Type:PSVirtualMachine
Aliases:VMProfile
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WriteAccelerator

Gibt an, ob WriteAccelerator auf dem Datenträger aktiviert oder deaktiviert werden soll.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

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

Ausgaben

PSVirtualMachine