Deprecation of IP Config parameters for the cmdlet New-AzRecoveryServicesAsrVMNicConfig

This article describes the deprecation, the corresponding implications, and the alternative options available for the customers for the following scenario.

Configuring primary IP config settings for failover or test failover.

This cmdlet impacts all customers of Azure to Azure DR scenario using the cmdlet New-AzRecoveryServicesAsrVMNicConfig in Version Az PowerShell 5.9.0 and above.

What changes should you expect?

The New-AzRecoveryServicesAsrVMNicConfig cmdlet uses the following parameters to configure the IP config values for FO/TFO:

• RecoveryVMSubnetName
• RecoveryNicStaticIPAddress
• RecoveryPublicIPAddressId
• RecoveryLBBackendAddressPoolId
• TfoVMSubnetName
• TfoNicStaticIPAddress
• TfoPublicIPAddressId
• TfoLBBackendAddressPoolId

The cmdlet no longer accepts these parameters.

• Starting 4 May 2021, you receive Azure portal notifications and email communications about the deprecation of IP config parameters in the cmdlet New-AzRecoveryServicesAsrVMNicConfig.

• If you have an existing script that uses these parameters, it isn't supported.

Alternatives

As an alternative, use the new cmdlet New-AzRecoveryServicesAsrVMNicIPConfig for configuring IP Config FO/TFO settings.

Remediation steps

Modify your scripts to remove these parameters. Instead, start using the new cmdlet New-AzRecoveryServicesAsrVMNicIPConfig to create an IP Config object. Here's an illustration:

Your existing scripts use the following code:

# Fetching the Protected Item Object (for the Protected VM)
$protectedItemObject = Get-AsrReplicationProtectedItem -ProtectionContainer $primaryContainerObject | where { $_.FriendlyName -eq $VMName };$protectedItemObject

# ID of the NIC whose settings are to be updated.
$nicId = $protectedItemObject.NicDetailsList[0].NicId

$nic1 = New-AzRecoveryServicesAsrVMNicConfig -NicId $nicId -ReplicationProtectedItem $protectedItemObject -RecoveryVMNetworkId <networkArmId> -TfoVMNetworkId <networkArmId> -RecoveryVMSubnetName "default" -TfoVMSubnetName "default" -RecoveryNicStaticIPAddress "10.1.40.223" -TfoNicStaticIPAddress "10.33.0.223"

$nics = @($nic1)
Set-AzRecoveryServicesAsrReplicationProtectedItem -InputObject $protectedItemObject -ASRVMNicConfiguration $nics

Modify your scripts as shown::

# Fetching the Protected Item Object (for the Protected VM)
$protectedItemObject = Get-AsrReplicationProtectedItem -ProtectionContainer $primaryContainerObject | where { $_.FriendlyName -eq $VMName };$protectedItemObject

# Create the config object for Primary IP Config
$ipConfig = New-AzRecoveryServicesAsrVMNicIPConfig  -IpConfigName <ipConfigName> -RecoverySubnetName "default" -TfoSubnetName "default" -RecoveryStaticIPAddress "10.1.40.223" -TfoStaticIPAddress "10.33.0.223"

$ipConfigs = @($ipConfig)

# ID of the NIC whose settings are to be updated.
$nicId = $protectedItemObject.NicDetailsList[0].NicId

$nic1 = New-AzRecoveryServicesAsrVMNicConfig -NicId $nicId -ReplicationProtectedItem $protectedItemObject -RecoveryVMNetworkId <networkArmId> -TfoVMNetworkId <networkArmId> -IPConfig $ipConfigs

$nics = @($nic1)
Set-AzRecoveryServicesAsrReplicationProtectedItem -InputObject $protectedItemObject -ASRVMNicConfiguration $nics

Next steps

Modify your scripts as illustrated in this article. If you have any questions, contact Microsoft Support.