Move-RDVirtualDesktop

아티클
11/16/2015

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> ] [ <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.

별칭	없음
필수 여부	false
위치	4
기본값	없음
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-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.

별칭	없음
필수 여부	false
위치	5
기본값	없음
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-DestinationHost<String>

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

별칭	없음
필수 여부	true
위치	2
기본값	없음
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-Name<String>

Specifies the name of a virtual desktop.

별칭	없음
필수 여부	true
위치	3
기본값	없음
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-SourceHost<String>

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

별칭	없음
필수 여부	true
위치	1
기본값	없음
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

<CommonParameters>

이 cmdlet은 일반 매개 변수 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer 및 -OutVariable을 지원합니다. 자세한 내용은 다음을 참조하세요. about_CommonParameters(https://go.microsoft.com/fwlink/p/?LinkID=113216).

입력

입력 유형은 cmdlet에 파이프할 수 있는 개체의 유형입니다.

출력

출력 유형은 cmdlet이 내보내는 개체의 유형입니다.

Null

This cmdlet does not have an output object.

예제

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.

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

Move-RDVirtualDesktop