Set-AzMigrateHCIServerReplication
Updates the target properties for the replicating server.
Syntax
Set-AzMigrateHCIServerReplication
-TargetObjectID <String>
[-TargetVMName <String>]
[-TargetVMCPUCore <Int32>]
[-IsDynamicMemoryEnabled <String>]
[-DynamicMemoryConfig <ProtectedItemDynamicMemoryConfig>]
[-TargetVMRam <Int64>]
[-NicToInclude <AzStackHCINicInput[]>]
[-SubscriptionId <String>]
[-DefaultProfile <PSObject>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
The Set-AzMigrateHCIServerReplication cmdlet updates the target properties for the replicating server.
Examples
Example 1: Update target VM name
Set-AzMigrateHCIServerReplication -TargetObjectID '/subscriptions/xxx-xxx-xxx/resourceGroups/test-rg/providers/Microsoft.DataReplication/replicationVaults/proj62434replicationvault/protectedItems/00001111-aaaa-2222-bbbb-3333cccc4444' -TargetVMName "targetName1"
ActivityId : ActivityId: 00000000-0000-0000-0000-000000000000
AllowedAction : {}
CustomPropertyAffectedObjectDetail : Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20210216Preview.WorkflowModelCustomPropertiesAffectedObjectDetails
CustomPropertyInstanceType : WorkflowDetails
DisplayName : Create or update protected item
EndTime : 1/1/1900 8:54:47 PM
Error : {}
Id : /subscriptions/xxx-xxx-xxx/resourceGroups/test-rg/providers/Microsoft.DataReplication/replicationVaults/proj62434replicationvault/jobs/f2d3430a-2977-419f-abd5-11d171e17f5e
Name : f2d3430a-2977-419f-abd5-11d171e17f5e
ObjectId : /subscriptions/xxx-xxx-xxx/resourceGroups/test-rg/providers/Microsoft.DataReplication/replicationVaults/proj62434replicationvault/protectedItems/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
ObjectInternalId : a8b5ee68-102c-5aae-9499-c57a475a8fd4
ObjectInternalName : test_vm
ObjectName : aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
ObjectType : ProtectedItem
ReplicationProviderId : xxx-xxx-xxx
SourceFabricProviderId : b35da11c-d69e-4220-9a90-d81ed93ad2fc
StartTime : 1/1/1900 8:49:27 PM
State : Succeeded
SystemDataCreatedAt :
SystemDataCreatedBy :
SystemDataCreatedByType :
SystemDataLastModifiedAt :
SystemDataLastModifiedBy :
SystemDataLastModifiedByType :
Tag : Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20210216Preview.WorkflowModelTags
TargetFabricProviderId : 22f00372-a1b7-467f-87ce-d95e17a6e7c7
Task : {Creating or updating the protected item, Initializing Protection, Enabling Protection, Starting Replication}
Type : Microsoft.DataReplication/replicationVaults/jobs
Update target VM name
Example 2: Update dynamic memory configuration
$memoryConfig = [PSCustomObject]@{
MinimumMemoryInMegaByte = 1024
MaximumMemoryInMegaByte = 34816
TargetMemoryBufferPercentage = 20
}
Set-AzMigrateHCIServerReplication -TargetObjectID '/subscriptions/xxx-xxx-xxx/resourceGroups/test-rg/providers/Microsoft.DataReplication/replicationVaults/proj62434replicationvault/protectedItems/00001111-aaaa-2222-bbbb-3333cccc4444' -DynamicMemoryConfig $memoryConfig
ActivityId : ActivityId: 00000000-0000-0000-0000-000000000000
AllowedAction : {}
CustomPropertyAffectedObjectDetail : Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20210216Preview.WorkflowModelCustomPropertiesAffectedObjectDetails
CustomPropertyInstanceType : WorkflowDetails
DisplayName : Create or update protected item
EndTime : 1/1/1900 8:54:47 PM
Error : {}
Id : /subscriptions/xxx-xxx-xxx/resourceGroups/test-rg/providers/Microsoft.DataReplication/replicationVaults/proj62434replicationvault/jobs/f2d3430a-2977-419f-abd5-11d171e17f5e
Name : f2d3430a-2977-419f-abd5-11d171e17f5e
ObjectId : /subscriptions/xxx-xxx-xxx/resourceGroups/test-rg/providers/Microsoft.DataReplication/replicationVaults/proj62434replicationvault/protectedItems/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
ObjectInternalId : a8b5ee68-102c-5aae-9499-c57a475a8fd4
ObjectInternalName : test_vm
ObjectName : aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
ObjectType : ProtectedItem
ReplicationProviderId : xxx-xxx-xxx
SourceFabricProviderId : b35da11c-d69e-4220-9a90-d81ed93ad2fc
StartTime : 1/1/1900 8:49:27 PM
State : Succeeded
SystemDataCreatedAt :
SystemDataCreatedBy :
SystemDataCreatedByType :
SystemDataLastModifiedAt :
SystemDataLastModifiedBy :
SystemDataLastModifiedByType :
Tag : Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20210216Preview.WorkflowModelTags
TargetFabricProviderId : 22f00372-a1b7-467f-87ce-d95e17a6e7c7
Task : {Creating or updating the protected item, Initializing Protection, Enabling Protection, Starting Replication}
Type : Microsoft.DataReplication/replicationVaults/jobs
Update dynamic memory configuration.
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 |
-DynamicMemoryConfig
Specifies the dynamic memory configration of RAM. To construct, see NOTES section for DYNAMICMEMORYCONFIG properties and create a hash table.
Type: | ProtectedItemDynamicMemoryConfig |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsDynamicMemoryEnabled
Specifies if RAM is dynamic or not.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NicToInclude
Specifies the nics on the source server to be included for replication.
Type: | AzStackHCINicInput[] |
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 |
-TargetObjectID
Specifies the replicating server for which the properties need to be updated. 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 |
-TargetVMCPUCore
Specifies the number of CPU cores.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TargetVMName
Specifies the target VM name.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TargetVMRam
Specifies the target RAM size in MB.
Type: | Int64 |
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 |