Set-​Azure​Stor​Simple​Device​Volume

Updates the properties of an existing volume.

Syntax

Set-AzureStorSimpleDeviceVolume
   [-AccessControlRecords <System.Collections.Generic.List`1[Microsoft.WindowsAzure.Management.StorSimple.Models.AccessControlRecord]>]
   -DeviceName <String>
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [-NewName <String>]
   [-Online <Boolean>]
   [-Profile <AzureSMProfile>]
   -Volume <VirtualDisk>
   [-VolumeAppType <AppType>]
   [-VolumeSizeInBytes <Int64>]
   [-WaitForComplete]
   [<CommonParameters>]
Set-AzureStorSimpleDeviceVolume
   [-AccessControlRecords <System.Collections.Generic.List`1[Microsoft.WindowsAzure.Management.StorSimple.Models.AccessControlRecord]>]
   -DeviceName <String>
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [-NewName <String>]
   [-Online <Boolean>]
   [-Profile <AzureSMProfile>]
   [-VolumeAppType <AppType>]
   -VolumeName <String>
   [-VolumeSizeInBytes <Int64>]
   [-WaitForComplete]
   [<CommonParameters>]

Description

The Set-AzureStorSimpleDeviceVolume cmdlet updates the properties of an existing volume. This cmdlet associates a volume with one or more access control records. To obtain AccessControlRecord objects, use the Get-AzureStorSimpleAccessControlRecord cmdlet. Update the size or type for the volume. Also, update whether to create the volume online.

Examples

Example 1: Update online value for a volume

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

This command updates the volume named Volume18 to have an online value of $False. This command starts the task, and then returns a TaskResponse object. To see the status of the task, use the Get-AzureStorSimpleTask cmdlet.

Example 2: Modify online value and type

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

This command updates the volume named Volume18. It modifies the type and changes the value of the Online parameter to $True.

Required Parameters

-DeviceName

Specifies the name of the StorSimple device on which to update the volume exists.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Volume

Specifies the name of the volume to update.

Type:VirtualDisk
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-VolumeName

Specifies the name of the volume to update.

Type:String
Aliases:Name
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

-AccessControlRecords

Specifies a list of access control records to associate with the volume.

Type:System.Collections.Generic.List`1[Microsoft.WindowsAzure.Management.StorSimple.Models.AccessControlRecord]
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-InformationAction

Specifies how this cmdlet responds to an information event.The acceptable values for this parameter are:- Continue

  • Ignore
  • Inquire
  • SilentlyContinue
  • Stop
  • Suspend
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-InformationVariable

Specifies an information variable.

Type:String
Aliases:iv
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-NewName

Specifies a new name for the StorSimple device.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Online

Specifies whether the volume is online.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Profile

Specifies an Azure profile.

Type:AzureSMProfile
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-VolumeAppType

Specifies whether to update the volume to be a primary or archive volume. Valid values are: PrimaryVolume and ArchiveVolume.

Type:AppType
Aliases:AppType
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-VolumeSizeInBytes

Specifies the updated size, in bytes, for the volume.

Type:Int64
Aliases:SizeInBytes
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WaitForComplete

Indicates that this cmdlet waits for the operation to complete before it returns control to the Windows PowerShell console.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Inputs

List\<AccessControlRecord\>

This cmdlet accepts a list of AccessControlRecord objects to associate to a volume.

Outputs

TaskStatusInfo

This cmdlet returns a TaskStatusInfo object, if you specify the WaitForComplete parameter.