PowerShell Logo Small

New-RDVirtualDesktopDeployment



This is the built-in help made by Microsoft for the command 'New-RDVirtualDesktopDeployment', in PowerShell version 3 - as retrieved from Windows version 'Microsoft Windows Server 2012 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

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.