Set-AzureOSDisk
修改 Azure 虛擬機的主機快取模式。
注意
本文件中參考的 Cmdlet 用於管理使用 Azure Service Manager（ASM） API 的舊版 Azure 資源。 建立新的資源時，不建議使用此舊版 PowerShell 模組，因為 ASM 已排定淘汰。 如需詳細資訊，請參閱 Azure Service Manager 淘汰。
Az PowerShell 模組是使用 PowerShell 管理 Azure Resource Manager （ARM） 資源的建議 PowerShell 模組。
語法
Set-AzureOSDisk
[-HostCaching] <String>
-VM <IPersistentVM>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Set-AzureOSDisk
[[-HostCaching] <String>]
[-ResizedSizeInGB] <Int32>
-VM <IPersistentVM>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Description
Set-AzureOSDisk Cmdlet 會修改 Azure 虛擬機器作業系統磁碟的主機快取模式。 支援的主機快取模式為 ReadOnly 和 ReadWrite。 如果您在執行中的虛擬機上執行此 Cmdlet，該虛擬機會重新啟動。
範例
範例 1：使用管線將主機快取模式設定為 ReadOnly
PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "VirtualMachine02" | Set-AzureOSDisk -HostCaching "ReadOnly"此命令會使用 Get-AzureVM Cmdlet，在名為 ContosoService 的服務中取得名為 VirtualMachine02 的虛擬機。 命令會使用管線運算符，將虛擬機傳遞至目前的 Cmdlet。 目前的 Cmdlet 會將該虛擬機之操作系統磁碟的主機快取模式設定為 ReadOnly。
範例 2：將主機快取模式設定為 ReadWrite
PS C:\> $VM = Get-AzureVM -ServiceName "ContosoService" -Name "VirtualMachine02"
PS C:\> Set-AzureOSDisk "ReadWrite" -VM $myVM2第一個命令會在名為 ContosoService 的服務中取得名為 VirtualMachine02 的虛擬機，然後將它儲存在 變數中。
第二個命令會將該虛擬機之操作系統磁碟的主機快取模式設定為 ReadWrite。
參數
-HostCaching
指定作業系統磁碟的主機快取屬性。 有效值為：
- 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 |
-Profile
指定此 Cmdlet 從中讀取的 Azure 設定檔。 如果您未指定設定檔，此 Cmdlet 會從本機預設配置檔讀取。
| 類型: | AzureSMProfile |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ResizedSizeInGB
指定作業系統磁碟的新大小，以 GB 為單位。 大小必須大於目前的大小。
| 類型: | Int32 |
| Position: | 1 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-VM
指定此 Cmdlet 修改作業系統磁碟的虛擬機。 若要取得虛擬機物件，請使用 Get-AzureVM Cmdlet。
| 類型: | IPersistentVM |
| 別名: | InputObject |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |