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