< Back
Set-RDSessionHost
Post
NAME Set-RDSessionHost
SYNOPSIS
Configures one or more RD?? Session Host servers in a session collection.
SYNTAX
Set-RDSessionHost [-SessionHost] <String[]> [-NewConnectionAllowed] {Yes | NotUntilReboot | No} [-ConnectionBroker <String>] [<CommonParameters>]
DESCRIPTION
The Set-RDSessionHost cmdlet configures one or more Remote Desktop Session Host (RDSession Host) servers in a session collection by specifying
whether each server can accept new connections. RDSession Host is a Remote Desktop Services role service that lets users share Windows-based
programs or the full Windows desktop. Users can connect to a RDSession Host server to run programs, save files, and use network resources on that
server.
PARAMETERS
-ConnectionBroker [<String>]
Specifies the Remote Desktop Connection Broker (RDConnection Broker) server for this Remote Desktop deployment. If this parameter does not
appear, the default value is the fully qualified domain name (FQDN) of the local host.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-NewConnectionAllowed <RDServerNewConnectionAllowed>
Determines whether the RDSession Host servers specified by the SessionHost parameter can accept new connections. The acceptable values for
this parameter are: Yes, NotUntilReboot, or No.
Required? true
Position? 2
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-SessionHost <String[]>
Specifies an array that contains the name of one or more RD?? Session Host servers that you configure.
Required? true
Position? 1
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: Set values for an RD?? Session Host server
PS C:\\> Set-RDSessionHost -SessionHost "rdsh.contoso.com" -NewConnectionAllowed $True -ConnectionBroker "rdcb.contoso.com"
This command specifies values for an RDSession Host server named rdsh.contoso.com. Users can make new server connections to a session collection
on the RDConnection Broker server named rdcb.contoso.com.
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/?LinkId=294266
Add-RDSessionHost
Get-RDSessionHost
Remove-RDSessionHost
SYNOPSIS
Configures one or more RD?? Session Host servers in a session collection.
SYNTAX
Set-RDSessionHost [-SessionHost] <String[]> [-NewConnectionAllowed] {Yes | NotUntilReboot | No} [-ConnectionBroker <String>] [<CommonParameters>]
DESCRIPTION
The Set-RDSessionHost cmdlet configures one or more Remote Desktop Session Host (RDSession Host) servers in a session collection by specifying
whether each server can accept new connections. RDSession Host is a Remote Desktop Services role service that lets users share Windows-based
programs or the full Windows desktop. Users can connect to a RDSession Host server to run programs, save files, and use network resources on that
server.
PARAMETERS
-ConnectionBroker [<String>]
Specifies the Remote Desktop Connection Broker (RDConnection Broker) server for this Remote Desktop deployment. If this parameter does not
appear, the default value is the fully qualified domain name (FQDN) of the local host.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-NewConnectionAllowed <RDServerNewConnectionAllowed>
Determines whether the RDSession Host servers specified by the SessionHost parameter can accept new connections. The acceptable values for
this parameter are: Yes, NotUntilReboot, or No.
Required? true
Position? 2
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-SessionHost <String[]>
Specifies an array that contains the name of one or more RD?? Session Host servers that you configure.
Required? true
Position? 1
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: Set values for an RD?? Session Host server
PS C:\\> Set-RDSessionHost -SessionHost "rdsh.contoso.com" -NewConnectionAllowed $True -ConnectionBroker "rdcb.contoso.com"
This command specifies values for an RDSession Host server named rdsh.contoso.com. Users can make new server connections to a session collection
on the RDConnection Broker server named rdcb.contoso.com.
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/?LinkId=294266
Add-RDSessionHost
Get-RDSessionHost
Remove-RDSessionHost