Set-AzureDataDisk
修改 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 |