Export (0) Print
Expand All
Expand Minimize

New-RDVirtualDesktopDeployment

Windows Server 2012 R2 and Windows 8.1

Updated: October 17, 2013

Applies To: Windows 8.1, Windows PowerShell 4.0, Windows Server 2012 R2

New-RDVirtualDesktopDeployment

Installs role services for Virtual Desktop Infrastructure.

Syntax

Parameter Set: Default
New-RDVirtualDesktopDeployment [-ConnectionBroker] <String> [-WebAccessServer] <String> [-VirtualizationHost] <String[]> [[-CreateVirtualSwitch]] [ <CommonParameters>]




Detailed Description

The New-RDVirtualDesktopDeployment cmdlet installs the role services that Virtual Desktop Infrastructure (VDI) requires to create a virtual machine-based desktop deployment. You can specify the CreateVirtualSwitch parameter to create a pooled virtual desktop collection in addition to installing the role services.

In Windows Server® 2012, the Microsoft Virtual Desktop Infrastructure (VDI) deployment is a scenario-based installation that allows you to install, configure, and manage your virtual desktops from a central location.

Parameters

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


Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-CreateVirtualSwitch

Indicates that VDI creates a pooled virtual desktop collection that is based on a virtual hard disk of the virtual desktop template.


Aliases

none

Required?

false

Position?

4

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-VirtualizationHost<String[]>

Specifies the fully qualified domain name (FQDN) of the server that you want to run the Virtualization Host (RD Virtualization Host) role service.


Aliases

none

Required?

true

Position?

3

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WebAccessServer<String>

Specifies the fully qualified domain name (FQDN) of the server that you want to run the Remote Desktop Web Access (RD Web Access) role service.


Aliases

none

Required?

true

Position?

2

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

  • Null



    Null.



Examples

Example 1: Create a virtual desktop deployment

This command installs the role services that Virtual Desktop Infrastructure (VDI) requires to create a virtual machine-based desktop deployment. The command uses the CreateVirtualSwitch parameter to create a pooled virtual desktop collection.


PS C:\> New-RDVirtualDesktopDeployment -ConnectionBroker "rdcb.contoso.com" -WebAccessServer "rdwa.contoso.com" -VirtualizationHost "rdsh.contoso.com" -CreateVirtualSwitch

Example 2: Install role services for Virtual Desktop Infrastructure

This command installs the role services that Virtual Desktop Infrastructure (VDI) requires to create a virtual machine-based desktop deployment. The command installs the Remote Desktop Web Access (RD Web Access) role service on the server named "rdwa.contoso.com", and installs the Virtualization Host (RD Virtualization Host) role service on the servers named "rdsh-1.contoso.com" and "rdsh-2.contoso.com". The command does not create a pooled virtual desktop collection.


PS C:\> New-RDVirtualDesktopDeployment -ConnectionBroker "rdcb.contoso.com" -WebAccessServer "rdwa.contoso.com" -VirtualizationHost @("rdsh-1.contoso.com","rdsh-2.contoso.com")

Related topics

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft