Edit

Share via

Set-AzMigrateServerReplication

  • Reference
Module:
Az.Migrate

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>]
   [-LinuxLicenseType <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>]
   [-LinuxLicenseType <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/replicationJobs

By 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/replicationJobs

Updating 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

-LinuxLicenseType

Specifies if Azure Hybrid benefit is applicable for the source linux server to be migrated.

Type:String
Position:Named
Default value:None
Required:False
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

IJob