< Back

Start-AzureStorSimpleDeviceFailoverJob

Wed Jan 30, 2019 5:55 pm

NAME Start-AzureStorSimpleDeviceFailoverJob



SYNOPSIS

Initiates a failover operation of volume container groups.





SYNTAX

Start-AzureStorSimpleDeviceFailoverJob [-DeviceId] <String> [-VolumecontainerGroups] <0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]>

[-TargetDeviceId] <String> [[-Force]] [-Profile <AzureProfile>] [<CommonParameters>]



Start-AzureStorSimpleDeviceFailoverJob [-DeviceName] <String> [-VolumecontainerGroups] <0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]>

[-TargetDeviceName] <String> [[-Force]] [-Profile <AzureProfile>] [<CommonParameters>]



Start-AzureStorSimpleDeviceFailoverJob [-VolumecontainerGroups] <0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]> [[-Force]] [-Profile

<AzureProfile>] [<CommonParameters>]





DESCRIPTION

The Start-AzureStorSimpleDeviceFailoverJob cmdlet initiates a failover operation of one or more volume container groups from one device to another.





PARAMETERS

-DeviceId <String>

Specifies the instance ID of the StorSimple device on which the volume container groups exist.



Required? true

Position? 1

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-DeviceName <String>

Specifies the name of the StorSimple device on which the volume container groups exist.



Required? true

Position? 1

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-Force [<SwitchParameter>]

Forces the command to run without asking for user confirmation.



Required? false

Position? 4

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



-TargetDeviceId <String>

Specifies the instance ID of the StorSimple device to which this cmdlet fails over the volume container groups.



Required? true

Position? 3

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-TargetDeviceName <String>

Specifies the name of the StorSimple device to which this cmdlet fails over the volume container groups.



Required? true

Position? 3

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-VolumecontainerGroups <0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]>

Specifies the list of volume container groups that this cmdlet fails over to another device.



Required? true

Position? 2

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

List<DataContainerGroup>



You can pipe a list of volume container groups to this cmdlet.





OUTPUTS

String









NOTES





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



Example 1: Start a failover job for a named device and named target device



PS C:\\>(Get-AzureStorSimpleFailoverVolumeContainers -DeviceName "ChewD_App7") | Where-Object {$_.IsDCGroupEligibleForDR -eq $True} |

Start-AzureStorSimpleDeviceFailoverJob -DeviceName "ChewD_App7" -TargetDeviceName "Fuller05" -Force

a3d902be-8ffb-42a4-bbf8-0a1b30db71b2_0ee59ae9-0293-46e2-ae56-bc308c8e5520



This command gets the failover volume containers for the device named ChewD_App7 by using the Get-AzureStorSimpleFailoverVolumeContainers cmdlet. The

command passes the results to the Where-Object cmdlet, which drops those containers that have a value other than $True for the IsDCGroupEligibleForDR

property. For more information, type Get-Help Where-Object. The current cmdlet starts failover jobs for the remaining failover volume containers. The

command specifies the device name and target device name. The command returns the instance ID of the job that the cmdlet starts.





Example 2: Start a failover job for a device and target device specified by ID



PS C:\\>(Get-AzureStorSimpleFailoverVolumeContainers -DeviceId "3825f272-1efb-4c14-b63f-22605ce3b925") | Where-Object {$_.IsDCGroupEligibleForDR -eq

$True} | Select-Object -First 1 | Start-AzureStorSimpleDeviceFailoverJob -DeviceId "3825f272-1efb-4c14-b63f-22605ce3b925" -TargetDeviceId

"0ee59ae9-0293-46e2-ae56-bc308c8e5520" -Force

4c5ac0d0-4b66-465c-98f5-aec90505ad12_0ee59ae9-0293-46e2-ae56-bc308c8e5520



This command gets the failover volume containers for the device named ChewD_App7 by using Get-AzureStorSimpleFailoverVolumeContainers. The command

passes the results to Where-Object, which drops those containters that have a value other than $True for the IsDCGroupEligibleForDR property. The cmdlet

passes the results to the Select-Object cmdlet, which selects the first object to pass to the current cmdlet. For more information, type Get-Help

Select-Object. The current cmdlet starts failover jobs for the selected failover volume container. The command specifies the device ID and target device

ID. The command returns the instance ID of the job that the cmdlet starts.







RELATED LINKS

Get-AzureStorSimpleFailoverVolumeContainers