Start-AzMigrateHCIServerMigration
Starts the migration for the replicating server.
Syntax
Start-AzMigrateHCIServerMigration
-TargetObjectID <String>
[-TurnOffSourceServer]
[-SubscriptionId <String>]
[-DefaultProfile <PSObject>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Start-AzMigrateHCIServerMigration
[-TurnOffSourceServer]
[-SubscriptionId <String>]
-InputObject <IMigrateIdentity>
[-DefaultProfile <PSObject>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Starts the migration for the replicating server.
Examples
Example 1: Start migration by Id
Start-AzMigrateHCIServerMigration -TargetObjectID "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/test-rg/providers/Microsoft.DataReplication/replicationVaults/testproj1234replicationvault/protectedItems/0ec082d5-6827-457a-bae2-f986e1b94851"
ActivityId : ActivityId: 00000000-0000-0000-0000-000000000000
AllowedAction : {Cancel}
CustomPropertyAffectedObjectDetail : Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api2021
0216Preview.WorkflowModelCustomPropertiesAffectedObjectDe
tails
CustomPropertyInstanceType : FailoverWorkflowDetails
DisplayName : Planned failover
EndTime :
Error : {}
Id : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/test-rg/providers/Microsoft.DataReplication
/replicationVaults/testproj1234replicationvault/jobs/af0e1bf6-e3e6-482c-8345-b1a06d87af96
Name : af0e1bf6-e3e6-482c-8345-b1a06d87af96
ObjectId : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/test-rg/providers/Microsoft.DataReplication
/replicationVaults/testproj1234replicationvault/protectedItems/0ec082d5-6827-457a-bae2-f986e1b94851/plannedFai
lover
ObjectInternalId : a8b5ee68-102c-5aae-9499-c57a475a8fc4
ObjectInternalName : testmachine
ObjectName : 0ec082d5-6827-457a-bae2-f986e1b94851
ObjectType : ProtectedItem
ReplicationProviderId : 4de0fddc-bdfe-40d9-b60e-678bdce89630
SourceFabricProviderId : b35da11c-d69e-4220-9a90-d81ed93ad2fc
StartTime : 8/1/2023 12:42:19 AM
State : Started
SystemDataCreatedAt :
SystemDataCreatedBy :
SystemDataCreatedByType :
SystemDataLastModifiedAt :
SystemDataLastModifiedBy :
SystemDataLastModifiedByType :
Tag : Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api2021
0216Preview.WorkflowModelTags
TargetFabricProviderId : 22f00372-a1b7-467f-87ce-d95e17a6e7c7
Task : {Prerequisite check, Turning off resource on primary,
Starting failover, Preparing protected entities...}
Type : Microsoft.DataReplication/replicationVaults/jobs
Start AzStackHCI server migration by Id.
Example 2: Start migration by input object
$InputObject = Get-AzMigrateHCIServerReplication -TargetObjectID "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/test-rg/providers/Microsoft.DataReplication/replicationVaults/testproj1234replicationvault/protectedItems/0ec082d5-6827-457a-bae2-f986e1b94851"
Start-AzMigrateHCIServerMigration -InputObject $InputObject
$InputObject | Start-AzMigrateHCIServerMigration
ActivityId : ActivityId: 00000000-0000-0000-0000-000000000000
AllowedAction : {Cancel}
CustomPropertyAffectedObjectDetail : Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api2021
0216Preview.WorkflowModelCustomPropertiesAffectedObjectDe
tails
CustomPropertyInstanceType : FailoverWorkflowDetails
DisplayName : Planned failover
EndTime :
Error : {}
Id : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/test-rg/providers/Microsoft.DataReplication
/replicationVaults/testproj1234replicationvault/jobs/af0e1bf6-e3e6-482c-8345-b1a06d87af96
Name : af0e1bf6-e3e6-482c-8345-b1a06d87af96
ObjectId : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/test-rg/providers/Microsoft.DataReplication
/replicationVaults/testproj1234replicationvault/protectedItems/0ec082d5-6827-457a-bae2-f986e1b94851/plannedFai
lover
ObjectInternalId : a8b5ee68-102c-5aae-9499-c57a475a8fc4
ObjectInternalName : testmachine
ObjectName : 0ec082d5-6827-457a-bae2-f986e1b94851
ObjectType : ProtectedItem
ReplicationProviderId : 4de0fddc-bdfe-40d9-b60e-678bdce89630
SourceFabricProviderId : b35da11c-d69e-4220-9a90-d81ed93ad2fc
StartTime : 8/1/2023 12:42:19 AM
State : Started
SystemDataCreatedAt :
SystemDataCreatedBy :
SystemDataCreatedByType :
SystemDataLastModifiedAt :
SystemDataLastModifiedBy :
SystemDataLastModifiedByType :
Tag : Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api2021
0216Preview.WorkflowModelTags
TargetFabricProviderId : 22f00372-a1b7-467f-87ce-d95e17a6e7c7
Task : {Prerequisite check, Turning off resource on primary,
Starting failover, Preparing protected entities...}
Type : Microsoft.DataReplication/replicationVaults/jobs
Start AzStackHCI server migration by replication input object.
Parameters
-Confirm
Prompts you for confirmation before running the cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
The credentials, account, tenant, and subscription used for communication with Azure.
Type: | PSObject |
Aliases: | AzureRMContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Specifies the replicating server for which migration needs to be initiated. The server object can be retrieved using the Get-AzMigrateHCIServerReplication cmdlet. To construct, see NOTES section for INPUTOBJECT properties and create a hash table.
Type: | IMigrateIdentity |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SubscriptionId
Azure Subscription ID.
Type: | String |
Position: | Named |
Default value: | (Get-AzContext).Subscription.Id |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TargetObjectID
Specifies the replcating server for which migration needs to be initiated. The ID should be retrieved using the Get-AzMigrateHCIServerReplication cmdlet.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TurnOffSourceServer
Specifies whether the source server should be turned off post migration.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |