-
Notifications
You must be signed in to change notification settings - Fork 45
RDSessionCollection
dscbot edited this page Jan 21, 2026
·
1 revision
| Parameter | Attribute | DataType | Description | Allowed Values |
|---|---|---|---|---|
| CollectionName | Key | String | Specifies a name for the session collection. | |
| ConnectionBroker | Required | String | Specifies the Remote Desktop Connection Broker (RD Connection Broker) server for a Remote Desktop deployment. | |
| SessionHost | Required | StringArray[] | Specifies one or more RD Session Host servers to include in the session collection. | |
| CollectionDescription | Write | String | Specifies a description for the collection. | |
| Force | Write | Boolean | Indicates that servers may be added to or removed from the collection. |
This resource is used to configure the Remote Desktop Collection.
This example shows how to ensure a session collection is created.
configuration Example
{
Import-DscResource -ModuleName 'RemoteDesktopServicesDsc'
node localhost {
RDSessionCollection 'MyCollection' {
CollectionName = 'ExampleApplications'
SessionHost = 'sessionhost.server.fqdn'
ConnectionBroker = 'connectionbroker.server.fqdn'
CollectionDescription = 'A collection to deploy example applications'
}
}
}configuration RDSessionCollection_Full
{
Import-DscResource -modulename RemoteDesktopServicesDsc
node localhost
{
RDSessionCollection WeLoveDsc
{
ConnectionBroker = 'RDCB1.contoso.com'
CollectionName = 'WeLoveDsc'
SessionHost = 'RDSH1.contoso.com', 'RDSH2.contoso.com'
}
}
}