Set-AzMigrateServerReplication
Updates the target properties for the replicating server.
Syntax
Set-AzMigrateServerReplication
-TargetObjectID <String>
[-TargetVMName <String>]
[-TargetDiskName <String>]
[-TargetVMSize <String>]
[-TargetNetworkId <String>]
[-TestNetworkId <String>]
[-TargetResourceGroupID <String>]
[-NicToUpdate <IVMwareCbtNicInput[]>]
[-DiskToUpdate <IVMwareCbtUpdateDiskInput[]>]
[-TargetAvailabilitySet <String>]
[-TargetAvailabilityZone <String>]
[-SqlServerLicenseType <String>]
[-UpdateTag <Hashtable>]
[-UpdateTagOperation <String>]
[-UpdateVMTag <IVMwareCbtEnableMigrationInputTargetVmtags>]
[-UpdateVMTagOperation <String>]
[-UpdateNicTag <IVMwareCbtEnableMigrationInputTargetNicTags>]
[-UpdateNicTagOperation <String>]
[-UpdateDiskTag <IVMwareCbtEnableMigrationInputTargetDiskTags>]
[-UpdateDiskTagOperation <String>]
[-TargetBootDiagnosticsStorageAccount <String>]
[-SubscriptionId <String>]
[-DefaultProfile <PSObject>]
[<CommonParameters>] Set-AzMigrateServerReplication
[-TargetVMName <String>]
[-TargetDiskName <String>]
[-TargetVMSize <String>]
[-TargetNetworkId <String>]
[-TestNetworkId <String>]
[-TargetResourceGroupID <String>]
[-NicToUpdate <IVMwareCbtNicInput[]>]
[-DiskToUpdate <IVMwareCbtUpdateDiskInput[]>]
[-TargetAvailabilitySet <String>]
[-TargetAvailabilityZone <String>]
[-SqlServerLicenseType <String>]
[-UpdateTag <Hashtable>]
[-UpdateTagOperation <String>]
[-UpdateVMTag <IVMwareCbtEnableMigrationInputTargetVmtags>]
[-UpdateVMTagOperation <String>]
[-UpdateNicTag <IVMwareCbtEnableMigrationInputTargetNicTags>]
[-UpdateNicTagOperation <String>]
[-UpdateDiskTag <IVMwareCbtEnableMigrationInputTargetDiskTags>]
[-UpdateDiskTagOperation <String>]
[-TargetBootDiagnosticsStorageAccount <String>]
[-SubscriptionId <String>]
-InputObject <IMigrationItem>
[-DefaultProfile <PSObject>]
[<CommonParameters>] Description
The Set-AzMigrateServerReplication cmdlet updates the target properties for the replicating server.
Examples
Example 1: Update by id
Set-AzMigrateServerReplication -TargetObjectID '/Subscriptions/xxx-xxx-xxx/resourceGroups/azmigratepwshtestasr13072020/providers/Microsoft.RecoveryServices/vaults/AzMigrateTestProjectPWSH02aarsvault/replicationFabrics/AzMigratePWSHTc8d1replicationfabric/replicationProtectionContainers/AzMigratePWSHTc8d1replicationcontainer/replicationMigrationItems/bcdr-vcenter-fareast-corp-micro-cfcc5a24-a40e-56b9-a6af-e206c9ca4f93_500f44f8-2aa3-587b-8958-ead358639629' -TargetVMName 'rb-w2k12r2-1'
ActivityId : da958651-96b3-4e65-a41e-897d4b06f7dd ActivityId: 3a4c8d4d-920a-47cd-82c3-f3dcce90a588
AllowedAction : {Cancel}
CustomDetailAffectedObjectDetail : Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20180110.JobDetailsAffectedObjectDetails
CustomDetailInstanceType : AsrJobDetails
EndTime :
Error : {}
FriendlyName : Update
Id : /Subscriptions/xxx-xxx-xxx/resourceGroups/azmigratepwshtestasr13072020/providers/Microsoft.Recover
yServices/vaults/AzMigrateTestProjectPWSH02aarsvault/replicationJobs/931dde9a-de67-4a30-a045-bb9d6162f8ab
Location :
Name : 931dde9a-de67-4a30-a045-bb9d6162f8ab
ScenarioName : Update
StartTime : 9/25/20 9:20:08 PM
State : InProgress
StateDescription : InProgress
TargetInstanceType : ProtectionEntity
TargetObjectId : 101883a0-23f7-538a-bbd5-6d8b4fa900e2
TargetObjectName : prsadhu-TestVM
Task : {DisableProtectionOnPrimary, UpdateDraState}
Type : Microsoft.RecoveryServices/vaults/replicationJobsBy id.
Example 2: Update multiple disk names by id
$OSDisk = Set-AzMigrateDiskMapping -DiskID "6000C294-1217-dec3-bc18-81f117220424" -DiskName "ContosoDisk_1"
$DataDisk = Set-AzMigrateDiskMapping -DiskID "6000C292-79b9-bbdc-fb8a-f1fa8dbeff84" -DiskName "ContosoDisk_2"
$DiskMapping = $OSDisk, $DataDisk
Set-AzMigrateServerReplication -TargetObjectId "/Subscriptions/7c943c1b-5122-4097-90c8-861411bdd574/resourceGroups/cbtsignoff2105srcrg/providers/Microsoft.RecoveryServices/vaults/signoff2105app1452vault/replicationFabrics/signoff2105app1c36replicationfabric/replicationProtectionContainers/signoff2105app1c36replicationcontainer/replicationMigrationItems/idclab-vcen67-fareast-corp-micr-6f5e3b29-29ad-4e62-abbd-6cd33c4183ef_5015f6d8-fc84-afdf-de47-1eab79330f00" -DiskToUpdate $DiskMapping
ActivityId : c533d88d-2211-43c6-b615-7b46876d8882 ActivityId: de18df8b-8d43-4249-8989-846d33a124f6
AllowedAction : {}
CustomDetailAffectedObjectDetail : Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20210210.JobDetailsAffectedObje
ctDetails
CustomDetailInstanceType : AsrJobDetails
EndTime :
Error : {}
FriendlyName : Update the virtual machine
Id : /Subscriptions/7c943c1b-5122-4097-90c8-861411bdd574/resourceGroups/cbtsignoff2105src
rg/providers/Microsoft.RecoveryServices/vaults/signoff2105app1452vault/replicationJo
bs/6ec1cca6-87c7-4f14-9657-bd0469c02fcd
Location :
Name : 6ec1cca6-87c7-4f14-9657-bd0469c02fcd
ScenarioName : UpdateVmProperties
StartTime : 8/30/2021 7:08:51 AM
State : InProgress
StateDescription : InProgress
TargetInstanceType : ProtectionEntity
TargetObjectId : f3aa6bd4-1b60-52bb-b12d-e850f8d8f13c
TargetObjectName : Win2k16
Task : {UpdateVmPropertiesTask}
Type : Microsoft.RecoveryServices/vaults/replicationJobsUpdating disk name by id.
Parameters
-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 |
-DiskToUpdate
Updates the disk for the Azure VM to be created. To construct, see NOTES section for DISKTOUPDATE properties and create a hash table.
| Type: | IVMwareCbtUpdateDiskInput[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
Specifies the replicating server for which the properties need to be updated. The server object can be retrieved using the Get-AzMigrateServerReplication cmdlet. To construct, see NOTES section for INPUTOBJECT properties and create a hash table.
| Type: | IMigrationItem |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NicToUpdate
Updates the NIC for the Azure VM to be created. To construct, see NOTES section for NICTOUPDATE properties and create a hash table.
| Type: | IVMwareCbtNicInput[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SqlServerLicenseType
Specifies if Azure Hybrid benefit for SQL Server is applicable for the server to be migrated.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SubscriptionId
The subscription Id.
| Type: | String |
| Position: | Named |
| Default value: | (Get-AzContext).Subscription.Id |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TargetAvailabilitySet
Specifies the Availability Set to be used for VM creation.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TargetAvailabilityZone
Specifies the Availability Zone to be used for VM creation.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TargetBootDiagnosticsStorageAccount
Specifies the storage account to be used for boot diagnostics.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TargetDiskName
Specifies the name of the Azure VM to be created.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TargetNetworkId
Updates the Virtual Network id within the destination Azure subscription to which the server needs to be migrated.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TargetObjectID
Specifies the replcating server for which the properties need to be updated. The ID should be retrieved using the Get-AzMigrateServerReplication cmdlet.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TargetResourceGroupID
Updates the Resource Group id within the destination Azure subscription to which the server needs to be migrated.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TargetVMName
Specifies the replcating server for which the properties need to be updated. The ID should be retrieved using the Get-AzMigrateServerReplication cmdlet.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TargetVMSize
Updates the SKU of the Azure VM to be created.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TestNetworkId
Updates the Virtual Network id within the destination Azure subscription to which the server needs to be test migrated.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UpdateDiskTag
Specifies the tag to be used for disk creation. To construct, see NOTES section for UPDATEDISKTAG properties and create a hash table.
| Type: | IVMwareCbtEnableMigrationInputTargetDiskTags |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UpdateDiskTagOperation
Specifies update disk tag operation.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UpdateNicTag
Specifies the tag to be used for NIC creation. To construct, see NOTES section for UPDATENICTAG properties and create a hash table.
| Type: | IVMwareCbtEnableMigrationInputTargetNicTags |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UpdateNicTagOperation
Specifies update NIC tag operation.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UpdateTag
Specifies the tag to be used for Resource creation.
| Type: | Hashtable |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UpdateTagOperation
Specifies update tag operation.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UpdateVMTag
Specifies the tag to be used for VM creation. To construct, see NOTES section for UPDATEVMTAG properties and create a hash table.
| Type: | IVMwareCbtEnableMigrationInputTargetVmtags |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UpdateVMTagOperation
Specifies update VM tag operation.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Outputs
Azure PowerShell
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for