共用方式為

Set-AzureRMVMDataDisk

  • 參考
模組:
AzureRM.Compute

修改虛擬機數據磁碟的屬性。

警告

自 2024 年 2 月 29 日起，AzureRM PowerShell 模組已正式淘汰。 建議使用者從 AzureRM 遷移至 Az PowerShell 模組，以確保持續支援和更新。

雖然 AzureRM 模組可能仍可運作，但不再維護或支援它，但會根據用戶的判斷權和風險放置任何繼續使用。 如需轉換至 Az 模組的指引，請參閱我們的 移轉資源 。

語法

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

Description

Set-AzureRmVMDataDisk Cmdlet 會修改虛擬機數據磁碟的屬性。

範例

範例 1：修改數據磁碟的快取模式

PS C:\> $VM = Get-AzureRMVM -ResourceGroupName "ResourceGroup11" -VMName "ContosoVM07"
PS C:\> Set-AzureRmVMDataDisk -VM $VM -Name "DataDisk01" -Caching ReadWrite | Update-AzureRmVM

第一個命令會使用 Get-AzureRmVM 取得名為 ContosoVM07 的虛擬機。 命令會將它儲存在 $VM 變數中。 第二個命令會修改虛擬機上名為 DataDisk01 的數據磁碟快取模式，$VM。 此命令會將結果傳遞至 Update-AzureRmVM Cmdlet，以實作您的變更。 對現金模式的變更會導致虛擬機重新啟動。

參數

-Caching

指定磁碟的快取模式。 此參數可接受的值為：

  • ReadOnly
  • ReadWrite 預設值為 ReadWrite。 變更此值會導致虛擬機重新啟動。 此設定會影響磁碟的一致性和效能。
類型:Nullable<T>[CachingTypes]
接受的值:None, ReadOnly, ReadWrite
Position:2
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:IAzureContextContainer
別名:AzureRmContext, AzureCredential
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-DiskSizeInGB

指定數據磁碟的大小，以 GB 為單位。

類型:Nullable<T>[Int32]
Position:3
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-Lun

指定此 Cmdlet 修改之數據磁碟的邏輯單元編號（LUN）。

類型:Nullable<T>[Int32]
Position:1
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-Name

指定此 Cmdlet 修改的數據磁碟名稱。

類型:String
Position:1
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-StorageAccountType

虛擬機受控磁碟的帳戶類型。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-VM

指定此 Cmdlet 修改資料磁碟的虛擬機。 若要取得虛擬機物件，請使用 Get-AzureRmVM Cmdlet。

類型:PSVirtualMachine
別名:VMProfile
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-WriteAccelerator

指定是否應該在數據磁碟上啟用或停用 WriteAccelerator。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

PSVirtualMachine

String

Nullable<T>[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

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

輸出

PSVirtualMachine