Start-AzureStorSimpleDeviceFailoverJob

Initiates a failover operation of volume container groups.

Note

The cmdlets referenced in this documentation are for managing legacy Azure resources that use Azure Service Manager (ASM) APIs. This legacy PowerShell module isn't recommended when creating new resources since ASM is scheduled for retirement. For more information, see Azure Service Manager retirement.

The Az PowerShell module is the recommended PowerShell module for managing Azure Resource Manager (ARM) resources with PowerShell.

Syntax

Start-AzureStorSimpleDeviceFailoverJob
     -VolumecontainerGroups <System.Collections.Generic.List`1[Microsoft.WindowsAzure.Management.StorSimple.Models.DataContainerGroup]>
     [-Force]
     [-Profile <AzureSMProfile>]
     [<CommonParameters>]
Start-AzureStorSimpleDeviceFailoverJob
     -DeviceId <String>
     -VolumecontainerGroups <System.Collections.Generic.List`1[Microsoft.WindowsAzure.Management.StorSimple.Models.DataContainerGroup]>
     -TargetDeviceId <String>
     [-Force]
     [-Profile <AzureSMProfile>]
     [<CommonParameters>]
Start-AzureStorSimpleDeviceFailoverJob
     -DeviceName <String>
     -VolumecontainerGroups <System.Collections.Generic.List`1[Microsoft.WindowsAzure.Management.StorSimple.Models.DataContainerGroup]>
     -TargetDeviceName <String>
     [-Force]
     [-Profile <AzureSMProfile>]
     [<CommonParameters>]

Description

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

Examples

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.

Parameters

-DeviceId

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DeviceName

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Force

Forces the command to run without asking for user confirmation.

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

-Profile

Specifies an Azure profile.

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

-TargetDeviceId

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-TargetDeviceName

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VolumecontainerGroups

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

Type:List<T>[DataContainerGroup]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Inputs

List\<DataContainerGroup\>

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

Outputs

String