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 ) # write-psfmessage -level VeryVerbose -message "Attempting to move VM named $VMName in RG $VMResourceGroup to host $Hostname in host group $hostgroup in RG $hostresourcegroup with DeallocateIfNeeded set to $deallocateifneeded and StartVMAfterMove set to $startvmaftermove" try { $DedicatedHost = Get-AzHost -HostGroupName $HostGroup -ResourceGroupName $HostResourceGroup -Name $HostName } catch { 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 } } |