New-AzMigrateHCINicMappingObject

Creates an object to update NIC properties of a replicating server.

Syntax

New-AzMigrateHCINicMappingObject
   -NicID <String>
   -TargetVirtualSwitchId <String>
   [-TargetTestVirtualSwitchId <String>]
   [-CreateAtTarget <String>]
   [<CommonParameters>]

Description

The New-AzMigrateHCINicMappingObject cmdlet creates a mapping of the source NIC attached to the server to be migrated. This object is provided as an input to the Set-AzMigrateServerReplication cmdlet to update the NIC and its properties for a replicating server.

Examples

Example 1: Create NIC to migrate

New-AzMigrateHCINicMappingObject -NicID a -TargetVirtualSwitchId "/subscriptions/xxx-xxx-xxx/resourceGroups/hciclus-rg/providers/Microsoft.AzureStackHCI/logicalnetworks/external"

NicId                    : a
TargetNetworkId          : /subscriptions/xxx-xxx-xxx/resourceGroups/hciclus-rg/providers/Microsoft.AzureStackHCI/logicalnetworks/external
TestNetworkId            : /subscriptions/xxx-xxx-xxx/resourceGroups/hciclus-rg/providers/Microsoft.AzureStackHCI/logicalnetworks/external
SelectionTypeForFailover : SelectedByUser

Get NIC object to provide input for New-AzMigrateHCIServerReplication and Set-AzMigrateHCIServerReplication

Parameters

-CreateAtTarget

Specifies whether the this Nic should be created at target.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NicID

Specifies the ID of the NIC to be updated.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-TargetTestVirtualSwitchId

Specifies the test logical network ARM ID that the VMs will use.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TargetVirtualSwitchId

Specifies the logical network ARM ID that the VMs will use.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Outputs

AzStackHCINicInput