< Back
Start-AzureStorSimpleDeviceFailoverJob
Post
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
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