PowerShell Logo Small

New-RDVirtualDesktopDeployment



This is the built-in help made by Microsoft for the command 'New-RDVirtualDesktopDeployment', 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

Installs role services for Virtual Desktop Infrastructure.

SYNTAX


New-RDVirtualDesktopDeployment [-ConnectionBroker] <String> [-WebAccessServer] <String> [-VirtualizationHost] <String[]> [[-CreateVirtualSwitch]] [<CommonParameters>]



Search powershellhelp.space

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.



<

RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/?LinkId=294243
New-RDSessionDeployment

REMARKS

<

Examples


Example 1: Create a virtual desktop deployment

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



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.




Example 2: Install role services for Virtual Desktop Infrastructure

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



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.