Cmdlets

Choose a cmdlet from the list on the left or search for a specific cmdlet. Choose a cmdlet from the list or search for a specific cmdlet.
About Help  Providers
 

Start-AzureStorSimpleDeviceFailoverJob

Start-AzureStorSimpleDeviceFailoverJob

microsoft.windowsazure.commands.storsimple.dll

Synopsis

Initiates a failover operation of volume container groups.

Syntax

Start-AzureStorSimpleDeviceFailoverJob [-DeviceId] [-VolumecontainerGroups] [-TargetDeviceId] [-Force] [-Profile] [<CommonParameters>]

Start-AzureStorSimpleDeviceFailoverJob [-DeviceName] [-VolumecontainerGroups] [-TargetDeviceName] [-Force] [-Profile] [<CommonParameters>]

Start-AzureStorSimpleDeviceFailoverJob [-VolumecontainerGroups] [-Force] [-Profile] [<CommonParameters>]

Detailed 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.

Aliases

none

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.

Aliases

none

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.

Aliases

none

Required?

false

Position

4

Default value

none

Accept pipeline input?

false

Accept wildcard characters?

false

-Profile <AzureProfile>

Specifies an Azure profile.

Aliases

none

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.

Aliases

none

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.

Aliases

none

Required?

true

Position

3

Default value

none

Accept pipeline input?

false

Accept wildcard characters?

false

-VolumecontainerGroups <0, Culture=neutral, PublicKeyToken=null>

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

Aliases

none

Required?

true

Position

2

Default value

none

Accept pipeline input?

true (ByValue)

Accept wildcard characters?

false

Input Type

List<DataContainerGroup>

Return Type

String

Notes

None

Examples

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

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.

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

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

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.

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

Get-AzureStorSimpleFailoverVolumeContainers