Replaces a network ip address / gateway (instead of adding a new one)

Replace-NetIpAddress.ps1

Function Replace-NetIpAddress{
[cmdletbinding()]
Param(
    [int]$interfaceIndex,
    [IPaddress]$NewIp,
    [int]$Prefix,
    [IPaddress]$Gateway
)

$IpParams = @{}

$CurrentIpConf = Get-NetIPConfiguration -InterfaceIndex $interfaceIndex

if ($CurrentIpConf.IPv4Address.IPAddress -ne $NewIp){

 $IpParams.add('InterfaceIndex', $interfaceIndex)
 $IpParams.add('IPAddress',$NewIp)
 $IpParams.Add('PrefixLength' ,$Prefix)

    $Adapter = Get-NetAdapter -InterfaceIndex $interfaceIndex
    $Adapter | Remove-NetIPAddress -Confirm:$false | Out-Null

}else{

    Write-Warning "The ip $($NewIp) is already set."

}


if ($Gateway){
        $CurrentGateway = ($CurrentIpConf).Ipv4DefaultGateway.nexthop
    if ($CurrentGateway -ne $Gateway){
        
        Get-NetRoute -InterfaceIndex $interfaceIndex -NextHop $CurrentGateway | Remove-NetRoute -Confirm:$false 
        $IpParams.add('DefaultGateway',$Gateway)
    }
    
    write-warning "Gateway $($Gateway) is already existing."
}

if ($IpParams.count -gt 0){
    New-NetIPAddress @IpParams
}else{

    Write-Warning "Ip configuration is identical as before"
}

}