Functions/Move-AHVMToDedicatedHost.ps1

Function Move-AHVMToDedicatedHost {
    <#
    .SYNOPSIS
        Moves a VM to the specified dedicated host
    .PARAMETER HostName
        The name of the host to move the VM to
    .PARAMETER HostResourceGroup
        The name of the ResourceGroup the Host is in
    .PARAMETER HostGroup
        The Host Group to move the VM to
    .PARAMETER VMName
        The name of the VM to move
    .PARAMETER VMResourceGroup
        The name of the Resource Group the VM is in
    .PARAMETER DeallocateIfNeeded
        If specified and the VM is not in a deallocated state then the VM is deallocated to move. If the VM is not in a deallocated state and this parameter is not specified then the move fails.
    .PARAMETER StartVMAfterMove
        If specified and the move is successful then the VM is started. The VM is started with -NoWait to return faster but does not guarantee the VM is finished booting.
    .Example
            Move-AHVMToDedicatedHost -HostName MyHost -HostResourceGroup HostRG -HostGroup MyHostG1 -VMName DHVM1 -VMResourceGroup VMRG -StartVMAfterMove
    .Notes
        Author: Paul Harrison
    #>


    [CmdletBinding()]
    param (
        [Parameter(Mandatory = $true)]
        [string]
        $HostName,
        [Parameter(Mandatory = $true)]
        [string]
        $HostResourceGroup,
        [Parameter(Mandatory = $true)]
        [string]
        $HostGroup,
        [Parameter(Mandatory = $true)]
        [string]
        $VMName,
        [Parameter(Mandatory = $true)]
        [string]
        $VMResourceGroup,
        [Parameter()]
        [switch]
        $DeallocateIfNeeded,
        [Parameter()]
        [switch]
        $StartVMAfterMove
    )

    $DedicatedHost = Get-AzHost -HostGroupName $HostGroup -ResourceGroupName $HostResourceGroup -Name $HostName
    IF (!$?) {
        throw "Error finding dedicated host"            
    }
    If (!$DedicatedHost) {
        throw "Dedicate Host not found"
    }
        
    try {
        $VM = Get-AzVM -ResourceGroupName $VMResourceGroup -Name $VMName
    }
    catch {
        throw "error finding VM"
    }    
    If (!$VM) {
        throw "VM not found"
    }
    If ('VM deallocated' -ne (Get-AzVM -ResourceGroupName $VMResourceGroup -Name $VMName -Status).statuses[1].DisplayStatus) {
        If ($DeallocateIfNeeded) {
            Stop-AzVM -ResourceGroupName $VMResourceGroup -Name $VMName -Force
        }
        Else {
            throw "$VMName in Resource Group $VMResourceGroup is not deallocated. Deallocate or specify the DeallocateIfNeeded switch."
        }
    }
        
    $VM.Host = New-Object Microsoft.Azure.Management.Compute.Models.SubResource
    $vm.Host.Id = $DedicatedHost.Id

    $Null = Update-AzVM -ResourceGroupName $VMResourceGroup -VM $VM

    If ($StartVMAfterMove) {
        $Null = Start-AzVM -ResourceGroupName $VMResourceGroup -Name $VMName -NoWait
    }
}