< Back

Set-AzureStorSimpleVirtualDevice

Wed Jan 30, 2019 5:54 pm

NAME Set-AzureStorSimpleVirtualDevice



SYNOPSIS

Creates or updates the device configuration of a StorSimple virtual device.





SYNTAX

Set-AzureStorSimpleVirtualDevice [-DeviceName] <String> [-SecretKey] <String> [-AdministratorPassword] <System.String> [-SnapshotManagerPassword]

<System.String> [[-TimeZone] <TimeZoneInfo>] [-Profile <AzureProfile>] [<CommonParameters>]





DESCRIPTION

The Set-AzureStorSimpleVirtualDevice cmdlet creates or updates the device configuration of an Azure StorSimple virtual device.





PARAMETERS

-AdministratorPassword <System.String>

Specifies the administrator password of the virtual device to configure.



Required? true

Position? 3

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-DeviceName <String>

Specifies the name of the virtual device to configure.



Required? true

Position? 1

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-Profile [<AzureProfile>]

Specifies an Azure profile.



Required? false

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-SecretKey <String>

Specifies a service encryption key for the virtual device. This key is generated when the first physical device is registered with a resource.



Required? true

Position? 2

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-SnapshotManagerPassword <System.String>

Specifies the snapshot manager password.



Required? true

Position? 4

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-TimeZone [<TimeZoneInfo>]

Specifies a time zone for the device. You can create a TimeZoneInfo object by using the GetSystemTimeZone() method. For example, this command

creates a time zone information object for Pacific Standard Time: [System.TimeZoneInfo]::GetSystemTimeZones() | where { $_.Id -eq "Pacific Standard

Time" }



Required? false

Position? 5

Default value none

Accept pipeline input? true(ByValue)

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

TimeZoneInfo



You can pipe a TimeZoneInfo object to this cmdlet.





OUTPUTS

DeviceJobDetails



This cmdlet returns updated device details for the virtual device.





NOTES





Keywords: azure, azuresm, servicemanagement, management, service, store, storsimple



Example 1: Update a virtual device



PS C:\\>$TimeZoneInfo = [System.TimeZoneInfo]::GetSystemTimeZones() | where { $_.Id -eq "Pacific Standard Time" }

PS C:\\> Set-AzureStorSimpleVirtualDevice -DeviceName "Contoso23" -SecretKey "wcZBlBGpCMf4USdSKyt/SQ==" -TimeZone $TimeZoneInfo

VERBOSE: ClientRequestId: e31f0d6b-451d-4c1d-b2f1-3fc84c13972c_PS

VERBOSE: ClientRequestId: df58db83-d563-4a2e-bbb4-9576f0e69ca6_PS

VERBOSE: ClientRequestId: 494a9f0d-79ee-4fde-ab4d-85ee5a357556_PS

VERBOSE: ClientRequestId: ce557cbf-174d-4301-93d4-5ffe082c8413_PS

VERBOSE: ClientRequestId: 31284dad-de2c-4758-a2ef-45962875bfa6_PS

VERBOSE: About to configure the device : win-ff93i74m1e1 !

VERBOSE: ClientRequestId: d9c66302-45d8-488a-adda-8ccf957f77d3_PS





TaskId : 21f530c3-bc47-4591-8c4e-da4d694b751d

TaskResult : Succeeded

TaskStatus : Completed

ErrorCode :

ErrorMessage :

TaskSteps : {Microsoft.WindowsAzure.Management.StorSimple.Models.TaskStep, Microsoft.WindowsAzure.Management.StorSimple.Models.TaskStep}



VERBOSE: The task created for your Setup operation has completed successfully.

VERBOSE: ClientRequestId: a94f972c-18ea-40b6-9401-2ad209c0c8b4_PS

AlertNotification : Microsoft.WindowsAzure.Management.StorSimple.Models.AlertNotificationSettings

Chap : Microsoft.WindowsAzure.Management.StorSimple.Models.ChapSettings

DeviceProperties : Microsoft.WindowsAzure.Management.StorSimple.Models.DeviceInfo

DnsServer : Microsoft.WindowsAzure.Management.StorSimple.Models.DnsServerSettings

InstanceId : d369ebb4-8b9a-47fc-9a6b-60f371e123ae

Name :

NetInterfaceList : {}

OperationInProgress : None

RemoteMgmtSettingsInfo : Microsoft.WindowsAzure.Management.StorSimple.Models.RemoteManagementSettings

RemoteMinishellSecretInfo : Microsoft.WindowsAzure.Management.StorSimple.Models.RemoteMinishellSettings

SecretEncryptionCertThumbprint :

Snapshot : Microsoft.WindowsAzure.Management.StorSimple.Models.SnapshotSettings

TimeServer : Microsoft.WindowsAzure.Management.StorSimple.Models.TimeSettings

Type : VirtualAppliance

VirtualApplianceProperties : Microsoft.WindowsAzure.Management.StorSimple.Models.VirtualApplianceInfo

WebProxy : Microsoft.WindowsAzure.Management.StorSimple.Models.WebProxySettings



VERBOSE: Successfully updated configuration for device Contoso23 with id d369ebb4-8b9a-47fc-9a6b-60f371e123ae



The first command uses the System.TimeZoneInfo .NET class and standard syntax to get Pacific Standard Time zone, and stores that object in the

$TimeZoneInfo variable.



The second command updates the device named Contoso23 to use the time zone specified in $TimeZoneInfo. The command requires the secret key to access the

virtual device configuration.





Example 2: Update a virtual device by using the pipeline operator



PS C:\\> [System.TimeZoneInfo]::GetSystemTimeZones() | where { $_.Id -eq "Pacific Standard Time" } | Set-AzureStorSimpleVirtualDevice -DeviceName

"Contoso23" -SecretKey "wcZBlBGpCMf4USdSKyt/SQ=="



This command updates the device named Contoso23 to use the time zone that the command creates. The command requires the secret key to access the virtual

device configuration. This command works the same way as the previous example, except that it passes the time zone to the current cmdlet by using the

pipeline operator.







RELATED LINKS

New-AzureStorSimpleVirtualDevice

Set-AzureStorSimpleDevice