< Back
New-RDSessionDeployment
Post
NAME New-RDSessionDeployment
SYNOPSIS
Installs the required role services for session-based desktop deployment.
SYNTAX
New-RDSessionDeployment [-ConnectionBroker] <String> [-SessionHost] <String[]> [[-WebAccessServer] <String>] [<CommonParameters>]
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 (RDWebAccess) role service, and one or more instances of the Remote Desktop Session Host (RDSession Host) role service.
PARAMETERS
-ConnectionBroker <String>
Specifies the FQDN of a server to host the RD?? Connection Broker role service.
Required? true
Position? 1
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-SessionHost <String[]>
Specifies an array of the FQDNs of servers to host the RD?? Session Host role service.
Required? true
Position? 2
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-WebAccessServer [<String>]
Specifies the FQDN of a server to host the RD?? Web?? Access role service.
Required? false
Position? 3
Default value none
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
Null
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.
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/?LinkId=294241
SYNOPSIS
Installs the required role services for session-based desktop deployment.
SYNTAX
New-RDSessionDeployment [-ConnectionBroker] <String> [-SessionHost] <String[]> [[-WebAccessServer] <String>] [<CommonParameters>]
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 (RDWebAccess) role service, and one or more instances of the Remote Desktop Session Host (RDSession Host) role service.
PARAMETERS
-ConnectionBroker <String>
Specifies the FQDN of a server to host the RD?? Connection Broker role service.
Required? true
Position? 1
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-SessionHost <String[]>
Specifies an array of the FQDNs of servers to host the RD?? Session Host role service.
Required? true
Position? 2
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-WebAccessServer [<String>]
Specifies the FQDN of a server to host the RD?? Web?? Access role service.
Required? false
Position? 3
Default value none
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
Null
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.
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/?LinkId=294241