Get-RDSessionCollectionConfiguration

업데이트 날짜: 2015년 6월

적용 대상: Windows 10, Windows Server Technical Preview

Get-RDSessionCollectionConfiguration

Gets configuration information for a session collection.

구문

Parameter Set: General
Get-RDSessionCollectionConfiguration [-CollectionName] <String> [-ConnectionBroker <String> ] [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [ <CommonParameters>]

Parameter Set: Client
Get-RDSessionCollectionConfiguration [-CollectionName] <String> -Client [-ConnectionBroker <String> ] [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [ <CommonParameters>]

Parameter Set: Connection
Get-RDSessionCollectionConfiguration [-CollectionName] <String> -Connection [-ConnectionBroker <String> ] [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [ <CommonParameters>]

Parameter Set: LoadBalancing
Get-RDSessionCollectionConfiguration [-CollectionName] <String> -LoadBalancing [-ConnectionBroker <String> ] [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [ <CommonParameters>]

Parameter Set: Security
Get-RDSessionCollectionConfiguration [-CollectionName] <String> -Security [-ConnectionBroker <String> ] [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [ <CommonParameters>]

Parameter Set: UserGroup
Get-RDSessionCollectionConfiguration [-CollectionName] <String> -UserGroup [-ConnectionBroker <String> ] [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [ <CommonParameters>]

Parameter Set: UserProfileDisk
Get-RDSessionCollectionConfiguration [-CollectionName] <String> -UserProfileDisk [-ConnectionBroker <String> ] [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [ <CommonParameters>]

자세한 설명

The Get-RDSessionCollectionConfiguration cmdlet gets configuration information for a specified session collection. A session collection consists of one or more Remote Desktop Session Host (RD Session Host) servers. Users can connect to RD Session Host servers in a session collection to run programs, save files, and use resources on those servers.

You can specify whether to get configuration resources for connection settings, load balancing settings, security settings, or user profile disk settings. You can also see the domain groups and users authorized to connect to the session.

매개 변수

-Client

Indicates that the cmdlet gets client settings for the session collection, such as those specified by the values of the ClientDeviceRedirectionOptions, ClientPrinterAsDefault, and ClientPrinterRedirected parameters in the Set-RDSessionCollectionConfiguration cmdlet.

-CollectionName<String>

Specifies the name of a session collection.

-Connection

Indicates that the cmdlet displays connection settings for the session collection.

-ConnectionBroker<String>

Specifies the Remote Desktop Connection Broker (RD Connection Broker) server for a Remote Desktop deployment. If you do not specify a value, the cmdlet uses the fully qualified domain name (FQDN) of the local computer.

-InformationAction<System.Management.Automation.ActionPreference>

Specifies how this cmdlet responds to an information event. The acceptable values for this parameter are:

-- SilentlyContinue
-- Stop
-- Continue
-- Inquire
-- Ignore
-- Suspend

-InformationVariable<System.String>

Specifies a variable in which to store an information event message.

-LoadBalancing

Indicates that the cmdlet gets load balancing settings for the session collection, such as those set by the LoadBalancing parameter in the Set-RDSessionCollectionConfiguration cmdlet.

-Security

Indicates that the parameter gets the security protocol in use for the session collection.

-UserGroup

Indicates that the cmdlet gets the list of domain groups and users authorized to connect to the session.

-UserProfileDisk

Indicates that the cmdlet gets settings for the user profile disk for the session collection.

<CommonParameters>

이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 TechNet의 about_CommonParameters(https://go.microsoft.com/fwlink/p/?LinkID=113216)

입력

입력 형식은 cmdlet으로 파이프할 수 있는 개체의 형식입니다.

출력

출력 형식은 cmdlet 실행 시 출력되는 개체의 형식입니다.

• System.Object

예

Example 1: Get domain groups authorized to connection to a session collection

This command gets settings for the session collection named Session Collection 22 that has the RD Connection Broker server named RDCB.Contoso.com. The command includes the UserGroup parameter, therefore the command gets the domain groups authorized to connect to the session collection.

PS C:\> Get-RDSessionCollectionConfiguration -CollectionName "Session Collection 22" -UserGroup -ConnectionBroker "RDCB.Contoso.com"

Example 2: Get connection settings for a session collection

This command gets settings for the session collection named Session Collection 22 that has the RD Connection Broker server named RDCB.Contoso.com. This command includes the Connection parameter, therefore the command gets connection settings.

PS C:\> Get-RDSessionCollectionConfiguration -CollectionName "Session Collection 22" -Connection -ConnectionBroker "RDCB.Contoso.com"

Example 3: Get user profile disk settings for a session collection

This command gets settings for the session collection named Session Collection 22 that has the RD Connection Broker server named RDCB.Contoso.com. This command includes the UserProfileDisk parameter, therefore the command gets settings for the user profile disk.

PS C:\> Get-RDSessionCollectionConfiguration -CollectionName "Session Collection 22" -UserProfileDisk -ConnectionBroker "RDCB.Contoso.com"

Example 4: Get security settings for a session collection

This command gets settings for the session collection named Session Collection 22 that has the RD Connection Broker server named RDCB.Contoso.com. This command includes the Security parameter, therefore the command gets security settings.

PS C:\> Get-RDSessionCollectionConfiguration -CollectionName "Session Collection 22" -Security -ConnectionBroker "RDCB.Contoso.com"

Example 5: Get load balancing settings for a session collection

This command gets settings for the session collection named Session Collection 22 that has the RD Connection Broker server named RDCB.Contoso.com. This command includes the LoadBalancing parameter, therefore the command gets load balancing settings.

PS C:\> Get-RDSessionCollectionConfiguration -CollectionName "Session Collection 22" -LoadBalancing -ConnectionBroker "RDCB.Contoso.com"

Example 6: Get client settings for a session collection

This command gets settings for the session collection named Session Collection 22 that has the RD Connection Broker server named RDCB.Contoso.com. This command includes the Client parameter, therefore the command gets client settings.

PS C:\> Get-RDSessionCollectionConfiguration -CollectionName "Session Collection 22" -Client -ConnectionBroker "RDCB.Contoso.com"

관련 항목

Set-RDSessionCollectionConfiguration

Get-RDSessionCollection

New-RDSessionCollection

Remove-RDSessionCollection