< Back
New-RDSessionCollection
Post
NAME New-RDSessionCollection
SYNOPSIS
Creates a session collection of RD Session Host servers.
SYNTAX
New-RDSessionCollection [-CollectionName] <String> [-AutoAssignUser] [-CollectionDescription <String>] [-ConnectionBroker <String>]
[-GrantAdministrativePrivilege] -PersonalUnmanaged -SessionHost <String[]> [<CommonParameters>]
New-RDSessionCollection [-CollectionName] <String> [-CollectionDescription <String>] [-ConnectionBroker <String>] [-PooledUnmanaged] -SessionHost
<String[]> [<CommonParameters>]
DESCRIPTION
The New-RDSessionCollection cmdlet creates a session collection that consists of one or more Remote Desktop Session Host (RDSession Host) servers.
Users can connect to RDSession Host servers in a session collection to run programs, save files, and use resources on those servers.
PARAMETERS
-AutoAssignUser [<SwitchParameter>]
Indicates that this cmdlet enables automatic session desktop assignments for a personal session collection.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-CollectionDescription [<String>]
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-CollectionName <String>
Required? true
Position? 1
Default value none
Accept pipeline input? true(ByPropertyName)
Accept wildcard characters? false
-ConnectionBroker [<String>]
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-GrantAdministrativePrivilege [<SwitchParameter>]
Indicates that the server grants administrative privileges to the user account that the server assigns to a given personal virtual desktop.
This parameter applies only to personal virtual desktop collections.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-PersonalUnmanaged <SwitchParameter>
Required? true
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-PooledUnmanaged [<SwitchParameter>]
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-SessionHost <String[]>
Required? true
Position? named
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
Microsoft.RemoteDesktopServices.Management.RDSessionCollection
Example 1: Create a session collection
PS C:\\> New-RDSessionCollection -CollectionName "Session Collection 02" -SessionHost @("RDSH01.Contoso.com"," RDSH02.Contoso.com")
-CollectionDescription "Session collection for West office hosts." -ConnectionBroker "RDCB.Contoso.com"
This command creates a session collection named Session Collection 02 in the Remote Desktop deployment that has the RDConnection Broker server
named RDCB.Contoso.com. The collection includes the RDSession Host servers named RDSH01.Contoso.com and RDSH02.Contoso.com. The command specifies
a description of the new collection.
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/?LinkId=294240
Get-RDSessionCollection
Remove-RDSessionCollection
SYNOPSIS
Creates a session collection of RD Session Host servers.
SYNTAX
New-RDSessionCollection [-CollectionName] <String> [-AutoAssignUser] [-CollectionDescription <String>] [-ConnectionBroker <String>]
[-GrantAdministrativePrivilege] -PersonalUnmanaged -SessionHost <String[]> [<CommonParameters>]
New-RDSessionCollection [-CollectionName] <String> [-CollectionDescription <String>] [-ConnectionBroker <String>] [-PooledUnmanaged] -SessionHost
<String[]> [<CommonParameters>]
DESCRIPTION
The New-RDSessionCollection cmdlet creates a session collection that consists of one or more Remote Desktop Session Host (RDSession Host) servers.
Users can connect to RDSession Host servers in a session collection to run programs, save files, and use resources on those servers.
PARAMETERS
-AutoAssignUser [<SwitchParameter>]
Indicates that this cmdlet enables automatic session desktop assignments for a personal session collection.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-CollectionDescription [<String>]
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-CollectionName <String>
Required? true
Position? 1
Default value none
Accept pipeline input? true(ByPropertyName)
Accept wildcard characters? false
-ConnectionBroker [<String>]
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-GrantAdministrativePrivilege [<SwitchParameter>]
Indicates that the server grants administrative privileges to the user account that the server assigns to a given personal virtual desktop.
This parameter applies only to personal virtual desktop collections.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-PersonalUnmanaged <SwitchParameter>
Required? true
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-PooledUnmanaged [<SwitchParameter>]
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-SessionHost <String[]>
Required? true
Position? named
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
Microsoft.RemoteDesktopServices.Management.RDSessionCollection
Example 1: Create a session collection
PS C:\\> New-RDSessionCollection -CollectionName "Session Collection 02" -SessionHost @("RDSH01.Contoso.com"," RDSH02.Contoso.com")
-CollectionDescription "Session collection for West office hosts." -ConnectionBroker "RDCB.Contoso.com"
This command creates a session collection named Session Collection 02 in the Remote Desktop deployment that has the RDConnection Broker server
named RDCB.Contoso.com. The collection includes the RDSession Host servers named RDSH01.Contoso.com and RDSH02.Contoso.com. The command specifies
a description of the new collection.
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/?LinkId=294240
Get-RDSessionCollection
Remove-RDSessionCollection