Set-RDSessionCollectionConfiguration

업데이트 날짜: 2015년 6월

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

Set-RDSessionCollectionConfiguration

Modifies configuration options for an existing session collection.

구문

Parameter Set: Default
Set-RDSessionCollectionConfiguration [-CollectionName] <String> [-ActiveSessionLimitMin <Int32> ] [-AuthenticateUsingNLA <Boolean> ] [-AutomaticReconnectionEnabled <Boolean> ] [-BrokenConnectionAction <RDBrokenConnectionAction> {None | Disconnect | LogOff} ] [-ClientDeviceRedirectionOptions <RDClientDeviceRedirectionOptions> {None | AudioVideoPlayBack | AudioRecording | COMPort | PlugAndPlayDevice | SmartCard | Clipboard | LPTPort | Drive | TimeZone} ] [-ClientPrinterAsDefault <Boolean> ] [-ClientPrinterRedirected <Boolean> ] [-CollectionDescription <String> ] [-ConnectionBroker <String> ] [-CustomRdpProperty <String> ] [-DisconnectedSessionLimitMin <Int32> ] [-EncryptionLevel <RDEncryptionLevel> {None | Low | ClientCompatible | High | FipsCompliant} ] [-IdleSessionLimitMin <Int32> ] [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [-LoadBalancing <RDSessionHostCollectionLoadBalancingInstance[]> ] [-MaxRedirectedMonitors <Int32> ] [-RDEasyPrintDriverEnabled <Boolean> ] [-SecurityLayer <RDSecurityLayer> {RDP | Negotiate | SSL} ] [-TemporaryFoldersDeletedOnExit <Boolean> ] [-TemporaryFoldersPerSession <Boolean> ] [-UserGroup <String[]> ] [ <CommonParameters>]

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

Parameter Set: EnableUserProfileDisk
Set-RDSessionCollectionConfiguration [-CollectionName] <String> -DiskPath <String> -EnableUserProfileDisk -MaxUserProfileDiskSizeGB <Int32> [-ConnectionBroker <String> ] [-ExcludeFilePath <String[]> ] [-ExcludeFolderPath <String[]> ] [-IncludeFilePath <String[]> ] [-IncludeFolderPath <String[]> ] [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [ <CommonParameters>]

자세한 설명

The Set-RDSessionCollectionConfiguration cmdlet modifies configuration options for an existing 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 use the New-RDSessionCollection cmdlet to create a session collection.

매개 변수

-ActiveSessionLimitMin<Int32>

Specifies the maximum time, in minutes, an active session runs. After this period, the RD Session Host server ends the session.

별칭	none
필수 여부	false
위치	named
기본값	none
파이프라인 입력 허용 여부	True (ByPropertyName)
와일드카드 문자 허용 여부	false

-AuthenticateUsingNLA<Boolean>

Indicates whether to use Network Level Authentication (NLA). If this value is $True, Remote Desktop uses NLA to authenticate a user before the user sees a logon screen.

별칭	none
필수 여부	false
위치	named
기본값	none
파이프라인 입력 허용 여부	True (ByPropertyName)
와일드카드 문자 허용 여부	false

-AutomaticReconnectionEnabled<Boolean>

Indicates whether the Remote Desktop client attempts to reconnect after a connection interruption.

별칭	none
필수 여부	false
위치	named
기본값	none
파이프라인 입력 허용 여부	True (ByPropertyName)
와일드카드 문자 허용 여부	false

-BrokenConnectionAction<RDBrokenConnectionAction>

Specifies an action for an RD Session Host server to take after a connection interruption. 이 매개 변수에 허용되는 값은 다음과 같습니다.

-- None
-- Disconnect
-- LogOff

별칭	none
필수 여부	false
위치	named
기본값	none
파이프라인 입력 허용 여부	True (ByPropertyName)
와일드카드 문자 허용 여부	false

-ClientDeviceRedirectionOptions<RDClientDeviceRedirectionOptions>

Specifies a type of client device to be redirected to an RD Session Host server in this session collection. 이 매개 변수에 허용되는 값은 다음과 같습니다.

-- 0x0000. None.
-- 0x0001. AudioVideoPlayBack.
-- 0x0002. AudioRecording.
-- 0x0004. COMPort.
-- 0x0008. PlugAndPlayDevice.
-- 0x0010. SmartCard.
-- 0x0020. Clipboard.
-- 0x0040. LPTPort.
-- 0x0080. Drive.
-- 0x0100. TimeZone.

You can use binary-or to combine two or more values of this enum to specify multiple client device types.

별칭	none
필수 여부	false
위치	named
기본값	none
파이프라인 입력 허용 여부	True (ByPropertyName)
와일드카드 문자 허용 여부	false

-ClientPrinterAsDefault<Boolean>

Indicates whether to use the client printer or server printer as the default printer. If this value is $True, use the client printer as default. If this value is $False, use the server as default.

별칭	none
필수 여부	false
위치	named
기본값	none
파이프라인 입력 허용 여부	True (ByPropertyName)
와일드카드 문자 허용 여부	false

-ClientPrinterRedirected<Boolean>

Indicates whether to use client printer redirection, which routes print jobs from the Remote Desktop session to a printer attached to the client computer.

별칭	none
필수 여부	false
위치	named
기본값	none
파이프라인 입력 허용 여부	True (ByPropertyName)
와일드카드 문자 허용 여부	false

-CollectionDescription<String>

Specifies a description of the session collection.

별칭	none
필수 여부	false
위치	named
기본값	none
파이프라인 입력 허용 여부	True (ByPropertyName)
와일드카드 문자 허용 여부	false

-CollectionName<String>

Specifies the name of a session collection.

별칭	none
필수 여부	true
위치	1
기본값	none
파이프라인 입력 허용 여부	True (ByPropertyName)
와일드카드 문자 허용 여부	false

-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.

별칭	none
필수 여부	false
위치	named
기본값	none
파이프라인 입력 허용 여부	false
와일드카드 문자 허용 여부	false

-CustomRdpProperty<String>

Specifies Remote Desktop Protocol (RDP) settings to include in the .rdp files for all Windows Server 2012 RemoteApp programs and remote desktops published in this collection.

별칭	none
필수 여부	false
위치	named
기본값	none
파이프라인 입력 허용 여부	True (ByPropertyName)
와일드카드 문자 허용 여부	false

-DisableUserProfileDisk

Indicates that Remote Desktop does not use a user profile to configure the session collection.

별칭	none
필수 여부	true
위치	named
기본값	none
파이프라인 입력 허용 여부	false
와일드카드 문자 허용 여부	false

-DisconnectedSessionLimitMin<Int32>

Specifies a length of time, in minutes. After client disconnection from a session for this period, the RD Session Host ends the session.

별칭	none
필수 여부	false
위치	named
기본값	none
파이프라인 입력 허용 여부	True (ByPropertyName)
와일드카드 문자 허용 여부	false

-DiskPath<String>

Specifies a path for the user profile disk.

별칭	none
필수 여부	true
위치	named
기본값	none
파이프라인 입력 허용 여부	True (ByPropertyName)
와일드카드 문자 허용 여부	false

-EnableUserProfileDisk

Indicates that Remote Desktop uses a user profile disk to configure the session collection. A user profile disk stores user profile information as a separate virtual hard disk in order to persist user profile settings across a pool of virtual desktops.

별칭	none
필수 여부	true
위치	named
기본값	none
파이프라인 입력 허용 여부	false
와일드카드 문자 허용 여부	false

-EncryptionLevel<RDEncryptionLevel>

Specifies the level of data encryption used for a Remote Desktop session. 이 매개 변수에 허용되는 값은 다음과 같습니다.

-- 0. Low.
-- 1. ClientCompatible.
-- 2. High.
-- 3. FipsCompliant.

The default value is ClientCompatible.

별칭	none
필수 여부	false
위치	named
기본값	none
파이프라인 입력 허용 여부	True (ByPropertyName)
와일드카드 문자 허용 여부	false

-ExcludeFilePath<String[]>

Specifies an array of file paths to exclude from a user profile disk. By default, Remote Desktop creates standard file and folder paths, such as Documents and Music. Use this parameter to prevent creation of specified file paths. This parameter overrides any identical values specified in the IncludeFilePath or IncludeFolderPath parameters.

별칭	none
필수 여부	false
위치	named
기본값	none
파이프라인 입력 허용 여부	True (ByPropertyName)
와일드카드 문자 허용 여부	false

-ExcludeFolderPath<String[]>

Specifies an array of folder paths to exclude from a user profile disk. By default, Remote Desktop creates standard file and folder paths, such as Documents and Music. Use this parameter to prevent creation of specified folder paths. This parameter overrides any identical values specified in the IncludeFilePath or IncludeFolderPath parameters.

별칭	none
필수 여부	false
위치	named
기본값	none
파이프라인 입력 허용 여부	True (ByPropertyName)
와일드카드 문자 허용 여부	false

-IdleSessionLimitMin<Int32>

Specifies the length of time, in minutes, to wait before an RD Session Host logs off or disconnects an idle session. The BrokenConnectionAction parameter determines whether to log off or disconnect.

별칭	none
필수 여부	false
위치	named
기본값	none
파이프라인 입력 허용 여부	True (ByPropertyName)
와일드카드 문자 허용 여부	false

-IncludeFilePath<String[]>

Specifies an array of file paths to include in a user profile disk.

별칭	none
필수 여부	false
위치	named
기본값	none
파이프라인 입력 허용 여부	True (ByPropertyName)
와일드카드 문자 허용 여부	false

-IncludeFolderPath<String[]>

Specifies an array of folder paths to include in a user profile disk.

별칭	none
필수 여부	false
위치	named
기본값	none
파이프라인 입력 허용 여부	True (ByPropertyName)
와일드카드 문자 허용 여부	false

-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

별칭	infa
필수 여부	false
위치	named
기본값	none
파이프라인 입력 허용 여부	false
와일드카드 문자 허용 여부	false

-InformationVariable<System.String>

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

별칭	iv
필수 여부	false
위치	named
기본값	none
파이프라인 입력 허용 여부	false
와일드카드 문자 허용 여부	false

-LoadBalancing<RDSessionHostCollectionLoadBalancingInstance[]>

Specifies an array of objects that defines load balancing guidelines for the remote session collection. Each object specifies the collection name, RD Session Host server name, relative weight to use for that server, and a maximum number of sessions to allow.

별칭	none
필수 여부	false
위치	named
기본값	none
파이프라인 입력 허용 여부	false
와일드카드 문자 허용 여부	false

-MaxRedirectedMonitors<Int32>

Specifies the maximum number of client monitors that an RD Session Host server can redirect to a remote session. The highest value for this parameter is 16.

별칭	none
필수 여부	false
위치	named
기본값	none
파이프라인 입력 허용 여부	True (ByPropertyName)
와일드카드 문자 허용 여부	false

-MaxUserProfileDiskSizeGB<Int32>

Specifies the maximum size, in gigabytes, for a user profile disk.

별칭	none
필수 여부	true
위치	named
기본값	none
파이프라인 입력 허용 여부	True (ByPropertyName)
와일드카드 문자 허용 여부	false

-RDEasyPrintDriverEnabled<Boolean>

Specifies whether to enable the Remote Desktop Easy Print driver.

별칭	none
필수 여부	false
위치	named
기본값	none
파이프라인 입력 허용 여부	True (ByPropertyName)
와일드카드 문자 허용 여부	false

-SecurityLayer<RDSecurityLayer>

Specifies which security protocol to use. 이 매개 변수에 허용되는 값은 다음과 같습니다.

-- 0. RDP.
-- 1. Negotiate.
-- 2. SSL.

The default value is Negotiate.

별칭	none
필수 여부	false
위치	named
기본값	none
파이프라인 입력 허용 여부	True (ByPropertyName)
와일드카드 문자 허용 여부	false

-TemporaryFoldersDeletedOnExit<Boolean>

Specifies whether to delete temporary folders from the RD Session Host server for a disconnected session.

별칭	none
필수 여부	false
위치	named
기본값	none
파이프라인 입력 허용 여부	True (ByPropertyName)
와일드카드 문자 허용 여부	false

-TemporaryFoldersPerSession<Boolean>

Specifies whether to use a single folder for temporary files. If this value is $True, a single folder contains temporary files. If this value is $False, individual users have separate folders to store temporary files.

별칭	none
필수 여부	false
위치	named
기본값	none
파이프라인 입력 허용 여부	false
와일드카드 문자 허용 여부	false

-UserGroup<String[]>

Specifies an array of domain groups and users authorized to connect to the RD Session Host servers in a session collection.

별칭	none
필수 여부	false
위치	named
기본값	none
파이프라인 입력 허용 여부	True (ByPropertyName)
와일드카드 문자 허용 여부	false

<CommonParameters>

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

입력

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

출력

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

• Null

참고

• The IncludeFolderPath and IncludeFilePath parameters are mutually exclusive with the ExcludeFolderPath and ExcludeFilePath parameters.

예

Example 1: Disable user profile disk

This command configures a session collection to not use a user profile disk for a session collection named Session Collection 02 that has an RD Connection Broker named RDCB.Contoso.com.

PS C:\> Set-RDSessionCollectionConfiguration -CollectionName "Session Collection 02" -DisableUserProfileDisk -ConnectionBroker "RDCB.Contoso.com"

Example 2: Specify a user profile disk with included file and folder

This command configures a session collection to use a user profile disk for a session collection named Session Collection 09 that has an RD Connection Broker named RDCB.Contoso.com. The command specifies the maximum size of the user profile disk and its disk path. The command specifies a path and file to include in the user profile.

PS C:\> Set-RDSessionCollectionConfiguration -CollectionName "Session Collection 09" -EnableUserProfileDisk -MaxUserProfileDiskSizeGB 40 -DiskPath "C:\UserVHDs" -IncludeFolderPath "C:\Resources Folder" -IncludeFileFolderPath "C:\Required Text File.txt" -ConnectionBroker "RDCB.Contoso.com"

Example 3: Specify a user profile disk with excluded file and folder

This command configures a session collection to use a user profile disk for a session collection named Session Collection 19 that has an RD Connection Broker named RDCB.Contoso.com. The command specifies the maximum size of the user profile disk and its disk path. The command specifies a path and file to exclude from the user profile.

PS C:\> Set-RDSessionCollectionConfiguration -CollectionName "Session Collection 19" -EnableUserProfileDisk -MaxUserProfileDiskSizeGB 40 -DiskPath "C:\UserVHDs" -ExcludeFolderPath "C:\Local Resources Folder" -ExcludeFilePath "C:\Local Text File.txt" -ConnectionBroker "RDCD.Contoso.com"

Example 4: Configure load balancing

This example configures load balancing for a session collection named Session Collection 07 that has an RD Connection Broker server named RDCB.Contoso.com.

The first five commands use standard Windows PowerShell® syntax to create an array of objects to define load balancing guidelines, and store those guidelines in the $LoadBalanceObjectsArray variable. This example configuration uses two RD Session Host servers named RDSH-1.Contoso.com and RDSH-2.Contoso.com

The final command specifies load balancing settings for the session collection that has the name Session Collection 07 and the RD Connection Broker server named RDCB.Contoso.com. The command uses the array stored in the $LoadBalanceObjectsArray variable to specify load balancing behavior.

PS C:\> $LoadBalanceObjectsArray = New-Object System.Collections.Generic.List[Microsoft.RemoteDesktopServices.Management.RDSessionHostCollectionLoadBalancingInstance] 
PS C:\>$LoadBalanceSessionHost1 = New-Object Microsoft.RemoteDesktopServices.Management.RDSessionHostCollectionLoadBalancingInstance( "SessionHostCollection", 50, 200, "RDSH-1.Contoso.com" )
PS C:\> $LoadBalanceObjectsArray.Add($LoadBalanceSessionHost1)
PS C:\> $LoadBalanceSessionHost2 = New-Object Microsoft.RemoteDesktopServices.Management.RDSessionHostCollectionLoadBalancingInstance( "SessionHostCollection", 50, 300, "RDSH-2Contoso.com" )
PS C:\> $LoadBalanceObjectsArray.Add($LoadBalanceSessionHost2)
PS C:\> Set-RDSessionCollectionConfiguration -CollectionName "Session Collection 07" -LoadBalancing $LoadBalanceObjectsArray -ConnectionBroker "RDCB.Contoso.com"

관련 항목

Get-RDSessionCollectionConfiguration

Get-RDSessionCollection

New-RDSessionCollection

Remove-RDSessionCollection