Set-AzureStorSimpleDeviceVolume
更新現有磁碟區的屬性。
注意
本文件中參考的 Cmdlet 用於管理使用 Azure Service Manager(ASM) API 的舊版 Azure 資源。 建立新的資源時,不建議使用此舊版 PowerShell 模組,因為 ASM 已排定淘汰。 如需詳細資訊,請參閱 Azure Service Manager 淘汰。
Az PowerShell 模組是使用 PowerShell 管理 Azure Resource Manager (ARM) 資源的建議 PowerShell 模組。
語法
Set-AzureStorSimpleDeviceVolume
-DeviceName <String>
-VolumeName <String>
[-Online <Boolean>]
[-VolumeSizeInBytes <Int64>]
[-VolumeAppType <AppType>]
[-AccessControlRecords <System.Collections.Generic.List`1[Microsoft.WindowsAzure.Management.StorSimple.Models.AccessControlRecord]>]
[-WaitForComplete]
[-NewName <String>]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
Set-AzureStorSimpleDeviceVolume
-DeviceName <String>
-Volume <VirtualDisk>
[-Online <Boolean>]
[-VolumeSizeInBytes <Int64>]
[-VolumeAppType <AppType>]
[-AccessControlRecords <System.Collections.Generic.List`1[Microsoft.WindowsAzure.Management.StorSimple.Models.AccessControlRecord]>]
[-WaitForComplete]
[-NewName <String>]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
Description
Set-AzureStorSimpleDeviceVolume Cmdlet 會更新現有磁碟區的屬性。 此 Cmdlet 會將磁碟區與一或多個訪問控制記錄產生關聯。 若要取得 AccessControlRecord 物件,請使用 Get-AzureStorSimpleAccessControlRecord Cmdlet。 更新磁碟區的大小或類型。 此外,請更新是否要在在線建立磁碟區。
範例
範例 1:更新磁碟區的在線值
PS C:\>Set-AzureStorSimpleDeviceVolume -DeviceName "Contoso63-AppVm" -VolumeName "Volume18" -Online $False
VERBOSE: ClientRequestId: f2869570-ea47-4be7-801e-9c0f22f2600d_PS
VERBOSE: ClientRequestId: c70bb86a-51d3-4390-be17-4d0847641dc3_PS
VERBOSE: ClientRequestId: d20cb5b2-6b3c-4e06-af99-cada28c5e50a_PS
VERBOSE: ClientRequestId: ab6d533e-b55b-4cfb-9c58-9153295e0547_PS
de7000f1-29c7-4102-a375-b52432f9e67e
VERBOSE: The update task is submitted successfully. Please use the command Get-AzureStorSimpleTask -InstanceId
de7000f1-29c7-4102-a375-b52432f9e67e for tracking the task's status
此命令會將名為 Volume18 的磁碟區更新為在線值$False。 此命令會啟動工作,然後傳 回TaskResponse 物件。 若要查看工作的狀態,請使用 Get-AzureStorSimpleTask Cmdlet。
範例 2:修改在線值和類型
PS C:\>Set-AzureStorSimpleDeviceVolume -DeviceName "Contoso63-AppVm" -VolumeName "Volume18" -Online $True -VolumeAppType ArchiveVolume
VERBOSE: ClientRequestId: af42b02a-645e-4801-a2d7-4197511c68cf_PS
VERBOSE: ClientRequestId: 7cb4f3b4-548e-42dc-a38c-0df0911c5206_PS
VERBOSE: ClientRequestId: 7cc706ad-a58f-4939-8e78-cabae8379a51_PS
VERBOSE: ClientRequestId: 6bed21d5-12fc-4a12-a89c-120bdb5636b1_PS
aa977225-af78-4c93-b754-72704afc928f
VERBOSE: The update task is submitted successfully. Please use the command Get-AzureStorSimpleTask -InstanceId
aa977225-af78-4c93-b754-72704afc928f for tracking the task's status
此命令會更新名為 Volume18 的磁碟區。 它會修改類型,並將 Online 參數的值變更為 $True。
參數
-AccessControlRecords
指定要與磁碟區建立關聯的訪問控制記錄清單。
類型: | List<T>[AccessControlRecord] |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-DeviceName
指定要更新磁碟區的 StorSimple 裝置名稱。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-InformationAction
指定此 Cmdlet 如何回應資訊事件。
此參數可接受的值為:
- 繼續
- 忽略
- 詢問
- SilentlyContinue
- 停止
- 暫止
類型: | ActionPreference |
別名: | infa |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-InformationVariable
指定資訊變數。
類型: | String |
別名: | iv |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-NewName
指定 StorSimple 裝置的新名稱。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Online
指定磁碟區是否在在線。
類型: | Boolean |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Profile
指定 Azure 設定檔。
類型: | AzureSMProfile |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Volume
指定要更新的磁碟區名稱。
類型: | VirtualDisk |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-VolumeAppType
指定將磁碟區更新為主要磁碟區或封存磁碟區。 有效值為:PrimaryVolume 和 ArchiveVolume。
類型: | AppType |
別名: | AppType |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-VolumeName
指定要更新的磁碟區名稱。
類型: | String |
別名: | Name |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-VolumeSizeInBytes
指定磁碟區的更新大小,以位元組為單位。
類型: | Int64 |
別名: | SizeInBytes |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-WaitForComplete
表示此 Cmdlet 會先等候作業完成,再將控制權傳回 Windows PowerShell 控制台。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
輸入
List\<AccessControlRecord\>
此 Cmdlet 接受 AccessControlRecord 物件清單,以與磁碟區產生關聯。
輸出
TaskStatusInfo
如果您指定 WaitForComplete 參數,此 Cmdlet 會傳回 TaskStatusInfo 物件。