Set-AzureDataDisk
修改 Azure 虛擬機器上現有資料磁片的主機快取。
注意
本檔中參考的 Cmdlet 用於管理使用服務管理 API 的舊版 Azure 資源。 如需管理 Azure Resource Manager 資源的 Cmdlet，請參閱 Az PowerShell 模組 。
Syntax
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 修改的資料磁片組態名稱。
| Type: | String |
| Position: | 3 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-HostCaching
警告
4 TiB 和更大的磁碟不支援磁碟快取。 如果將多個磁碟附加至您的 VM，小於 4 TiB 的每個磁碟會支援快取。
變更 Azure 磁碟的快取設定會將目標磁碟中斷連結再重新連結。 如果是作業系統磁片，則會重新開機 VM。 在變更磁碟快取設定之前，請先將可能受此中斷情況影響的所有應用程式/服務停止。 不遵循這些建議可能會導致資料損毀。
指定磁片的主機層級快取設定。 有效值為：
- 無
- 唯讀
- 讀寫
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InformationAction
指定此 Cmdlet 如何回應資訊事件。
此參數可接受的值為：
- 繼續
- 忽略
- 詢問
- SilentlyContinue
- 停止
- 暫止
| Type: | ActionPreference |
| Aliases: | infa |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InformationVariable
指定資訊變數。
| Type: | String |
| Aliases: | iv |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LUN
指定虛擬機器中資料磁片磁碟機的 LUN。 有效值為：0 到 15。
| Type: | Int32 |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Profile
指定此 Cmdlet 從中讀取的 Azure 設定檔。 如果您未指定設定檔，此 Cmdlet 會從本機預設設定檔讀取。
| Type: | AzureSMProfile |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ResizedSizeInGB
指定資料磁片的新大小，以 GB 為單位。 新的大小必須大於目前的大小。
| Type: | Int32 |
| Position: | 4 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VM
指定連接至資料磁片的虛擬機器物件。 若要取得虛擬機器物件，請使用 Get-AzureVM Cmdlet。
| Type: | IPersistentVM |
| Aliases: | InputObject |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |