Move-RDVirtualDesktop

업데이트 날짜: 2015년 6월

적용 대상: Windows 10, Windows Server Technical Preview

Move-RDVirtualDesktop

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

구문

Parameter Set: Default
Move-RDVirtualDesktop [-SourceHost] <String> [-DestinationHost] <String> [-Name] <String> [[-ConnectionBroker] <String> ] [[-Credential] <PSCredential> ] [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [ <CommonParameters>]

자세한 설명

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

매개 변수

-ConnectionBroker<String>

Specifies the Remote Desktop Connection Broker (RD Connection Broker) server for a remote desktop deployment. If you do not specify a value, the cmdlet uses the fully qualified domain name (FQDN) of the local computer.

-Credential<PSCredential>

Specifies a PSCredential object that contains the user credentials for the virtual desktop. Remote Desktop Services does not require user credentials if you run the cmdlet from the source host. If you do not specify user credentials for the virtual desktop and you run the cmdlet on a remote host, the server prompts you for credentials.

-DestinationHost<String>

Specifies the fully qualified domain name (FQDN) of the new RD Virtualization Host server for the virtual desktop.

-InformationAction<System.Management.Automation.ActionPreference>

Specifies how this cmdlet responds to an information event. The acceptable values for this parameter are:

-- SilentlyContinue
-- Stop
-- Continue
-- Inquire
-- Ignore
-- Suspend

-InformationVariable<System.String>

Specifies a variable in which to store an information event message.

-Name<String>

Specifies the name of a virtual desktop.

-SourceHost<String>

Specifies the fully qualified domain name (FQDN) of the current RD Virtualization Host server for the virtual desktop.

<CommonParameters>

이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 TechNet의 about_CommonParameters(https://go.microsoft.com/fwlink/p/?LinkID=113216)

입력

입력 형식은 cmdlet으로 파이프할 수 있는 개체의 형식입니다.

출력

출력 형식은 cmdlet 실행 시 출력되는 개체의 형식입니다.

• Null

예

Example 1: Move a virtual desktop to a new RD Virtualization Host server

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.

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.

The second command enables CredSSP authentication on the source host. The Enable-WSManCredSSP cmdlet delegates the server credentials to the delegate server.

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.

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:\> Enable-WSManCredSSP -Role "Client" -DelegateComputer * -Force
PS C:\> Enable-WSManCredSSP -Role "Server" -DelegateComputer * -Force
PS C:\> $Creds = Get-Credential
PS C:\> Move-RDVirtualDesktop -SourceHost "rdvh-1.contoso.com" -DestinationHost "rdvh-2.contoso.com" -Name "RDS-WKS-A2" -Credential $Creds

관련 항목

Add-RDVirtualDesktopToCollection

Get-RDVirtualDesktop

Get-RDVirtualDesktopCollection