PowerShell Logo Small

New-RDSessionDeployment



This is the built-in help made by Microsoft for the command 'New-RDSessionDeployment', 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 the required role services for session-based desktop deployment.

SYNTAX


New-RDSessionDeployment [-ConnectionBroker] <String> [-WebAccessServer] <String> [-SessionHost] <String[]> [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The New-RDSessionDeployment cmdlet installs role services required for the Virtual Desktop Infrastructure (VDI) to create a Remote Desktop Services (RDS) session-based
Remote Desktop deployment. A session-based deployment allows users to connect to session collections that include published Windows Server 2012 RemoteApp programs and
session-based desktops.


Specify the fully qualified domain names (FQDN) for servers to host a Remote Desktop Connection Broker (RDConnection Broker) role service, a Remote Desktop Web Access (RDWeb
Access) role service, and one or more instances of the Remote Desktop Session Host (RDSession Host) role service.



<

RELATED LINKS


Online Version: http://go.microsoft.com/fwlink/?LinkId=294241

REMARKS

<

Examples


Example 1: Install role services for a session deployment

PS C:\> New-RDSessionDeployment -ConnectionBroker "RDCB.Contoso.com" -WebAccessServer "RDWA.Contoso.com" -SessionHost "RDSH01.Contoso.com"



This command installs Remote Desktop role services on specified servers. The command installs an RDConnection Broker role service on the server named RDCB.Contoso.com. The
command installs an RDWebAccess role service on the server named RDWA.Contoso.com. The command installs the RDSession Host role service on the server named
RDSH01.Contoso.com.




Example 2: Install role services that include multiple RD Session Host servers

PS C:\> New-RDSessionDeployment -ConnectionBroker "RDCB.Contoso.com" -WebAccessServer "RDWA.Contoso.com" -SessionHost @("RDSH01.Contoso.com","RDSH02.Contoso.com")



This command installs Remote Desktop role services on specified servers. The command installs an RDConnection Broker role service on the server named RDCB.Contoso.com. The
command installs an RDWebAccess role service on the server named RDWA.Contoso.com. The command installs the RDSession Host role service on two servers, named
RDSH01.Contoso.com and RDSH02.Contoso.com.