共用方式為

Set-AzureDataDisk

  • 參考
模組:
Azure

修改 Azure 虛擬機上現有數據磁碟的主機快取。

注意

本文件中參考的 Cmdlet 用於管理使用 Azure Service Manager（ASM） API 的舊版 Azure 資源。 建立新的資源時，不建議使用此舊版 PowerShell 模組，因為 ASM 已排定淘汰。 如需詳細資訊，請參閱 Azure Service Manager 淘汰。

Az PowerShell 模組是使用 PowerShell 管理 Azure Resource Manager （ARM） 資源的建議 PowerShell 模組。

語法

Set-AzureDataDisk
   [-HostCaching] <String>
   [-LUN] <Int32>
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureDataDisk
   [-DiskName] <String>
   [-ResizedSizeInGB] <Int32>
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

Set-AzureDataDisk Cmdlet 會修改 Azure 虛擬機上現有數據磁碟的快取屬性。 指定要依其邏輯單元編號 （LUN） 更新的數據磁碟。

範例

範例 1：修改數據磁碟的主機快取

PS C:\> Get-AzureVM "ContosoService" | Set-AzureDataDisk -VM "VirtualMachine07" -LUN 2 -HostCaching ReadOnly | Update-AzureVM

此命令會使用 Get-AzureVM Cmdlet，取得在名為 ContosoService 的服務上執行的虛擬機。 命令會使用管線運算符將它們傳遞至目前的 Cmdlet。 該 Cmdlet 會將名為 VirtualMachine07 之虛擬機器 LUN 2 的數據磁碟設定為使用 ReadOnly 主機快取。 命令會更新虛擬機，以使用 Update-AzureVM Cmdlet來反映您的變更。

範例 2：修改虛擬機上所有數據磁碟的主機快取

PS C:\> Get-AzureVM "ContosoService" -Name "VirtualMachine07" | Get-AzureDataDisk | Set-AzureDataDisk -HostCaching ReadWrite | Update-AzureVM

此命令會取得 ContosoService 雲端服務上名為 VirtualMachine07 的虛擬機物件。 命令會將它 傳遞給 Get-AzureDataDisk Cmdlet，此 Cmdlet 會取得該虛擬機的數據磁碟。 然後，目前的 Cmdlet 會將每個數據磁碟的主機快取模式設定為 ReadWrite。 命令會更新虛擬機，以反映您的變更。

參數

-DiskName

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

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

-HostCaching

警告

4 TiB 和更大的磁碟不支援磁碟快取。 如果將多個磁碟附加至您的 VM，小於 4 TiB 的每個磁碟會支援快取。

變更 Azure 磁碟的快取設定會將目標磁碟中斷連結再重新連結。 如果是操作系統磁碟，則會重新啟動 VM。 在變更磁碟快取設定之前，請先將可能受此中斷情況影響的所有應用程式/服務停止。 未遵循這些建議可能會導致資料損毀。

指定磁碟的主機層級快取設定。 有效值為：

  • 無
  • ReadOnly
  • 讀寫
類型:String
Position:0
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-InformationAction

指定此 Cmdlet 如何回應資訊事件。

此參數可接受的值為：

  • 繼續
  • 忽略
  • 詢問
  • SilentlyContinue
  • 停止
  • 暫止
類型:ActionPreference
別名:infa
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-InformationVariable

指定資訊變數。

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

-LUN

指定虛擬機中數據磁碟驅動器的 LUN。 有效值為：0 到 15。

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

-Profile

指定此 Cmdlet 從中讀取的 Azure 設定檔。 如果您未指定設定檔，此 Cmdlet 會從本機預設配置檔讀取。

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

-ResizedSizeInGB

指定數據磁碟的新大小，以 GB 為單位。 新的大小必須大於目前的大小。

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

-VM

指定連接至數據磁碟的虛擬機物件。 若要取得虛擬機物件，請使用 Get-AzureVM Cmdlet。

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