PowerShell Logo Small

Move-RDVirtualDesktop



This is the built-in help made by Microsoft for the command 'Move-RDVirtualDesktop', in PowerShell version 5 - as retrieved from Windows version 'Microsoft Windows Server 2012 R2 Standard' PowerShell help files on 2016-06-23.

For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.

SYNOPSIS

Moves a virtual desktop to a new Remote Desktop Virtualization Host (RD Virtualization Host) server.

SYNTAX


Move-RDVirtualDesktop [-SourceHost] <String> [-DestinationHost] <String> [-Name] <String> [[-ConnectionBroker] <String>] [[-Credential] <PSCredential>] [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The Move-RDVirtualDesktop cmdlet moves a virtual desktop to a new Remote Desktop Virtualization Host (RD Virtualization Host) server.



<

RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/?LinkId=294236
Get-RDVirtualDesktop
Get-RDVirtualDesktopCollection
Add-RDVirtualDesktopToCollection

REMARKS

<

Examples


Example 1: Move a Virtual Desktop to a new RD Virtualization Host Server

The first command enables Credential Security Support Provider (CredSSP) authentication on the destination host. The Enable-WSManCredSSP cmdlet delegates the client
credentials to the delegate server.
PS C:\>Enable-WSManCredSSP -Role "Client" -DelegateComputer * -Force

The second command enables CredSSP authentication on the source host. The Enable-WSManCredSSP cmdlet delegates the server credentials to the delegate server.
PS C:\>Enable-WSManCredSSP -Role "Server" -DelegateComputer * -Force

The third command gets a credential object based on the user name and password that the user enters. The command stores the results in the $Creds variable.
PS C:\>$Creds = Get-Credential

The fourth command moves the virtual desktop named "RDS-WKS-A2" from the source host named "rdvh-1.contoso.com" to the destination host named "rdvh-2.contoso.com". The
command uses the credential object stored in the $Creds variable.
PS C:\>Move-RDVirtualDesktop -SourceHost "rdvh-1.contoso.com" -DestinationHost "rdvh-2.contoso.com" -Name "RDS-WKS-A2" -Credential $Creds



This example moves a virtual desktop from one RD Virtualization server to another. The commands run on the RD Connection Broker and move virtual desktops from the source
host to the destination host.