Set-RDVirtualDesktopCollectionConfiguration

업데이트 날짜: 2015년 6월

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

Set-RDVirtualDesktopCollectionConfiguration

Changes configuration settings for a virtual desktop collection.

구문

Parameter Set: General
Set-RDVirtualDesktopCollectionConfiguration [-CollectionName] <String> [-AutoAssignPersonalVirtualDesktopToUser <Boolean> ] [-ClientDeviceRedirectionOptions <RDClientDeviceRedirectionOptions> {None | AudioVideoPlayBack | AudioRecording | COMPort | PlugAndPlayDevice | SmartCard | Clipboard | LPTPort | Drive | TimeZone} ] [-CollectionDescription <String> ] [-ConnectionBroker <String> ] [-CustomRdpProperty <String> ] [-GrantAdministrativePrivilege <Boolean> ] [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [-RedirectAllMonitors <Boolean> ] [-RedirectClientPrinter <Boolean> ] [-SaveDelayMinutes <Int32> ] [-UserGroups <String[]> ] [ <CommonParameters>]

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

Parameter Set: EnableUserProfileDisks
Set-RDVirtualDesktopCollectionConfiguration [-CollectionName] <String> -DiskPath <String> -EnableUserProfileDisks -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-RDVirtualDesktopCollectionConfiguration cmdlet changes configuration settings for a virtual desktop collection.

매개 변수

-AutoAssignPersonalVirtualDesktopToUser<Boolean>

Indicates that the server automatically associates virtual desktops with user accounts when you create a new personal virtual desktop collection.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

false

와일드카드 문자 허용 여부

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 enumeration to specify multiple client device types.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-CollectionDescription<String>

Specifies a description for the collection.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-CollectionName<String>

Specifies the name of a personal virtual desktop 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 RemoteApp programs and remote desktops that you publish to this collection.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-DisableUserProfileDisks

Indicates that the server prevents you from using a user profile disk when you configure the collection.


별칭

none

필수 여부

true

위치

named

기본값

none

파이프라인 입력 허용 여부

false

와일드카드 문자 허용 여부

false

-DiskPath<String>

Specifies the path of the user profile disk.


별칭

none

필수 여부

true

위치

named

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-EnableUserProfileDisks

Indicates that the server enables a user profile disk when you configure the collection. A user profile disk stores user profile information in a separate virtual hard disk and saves user profile settings across pooled virtual desktops.


별칭

none

필수 여부

true

위치

named

기본값

none

파이프라인 입력 허용 여부

false

와일드카드 문자 허용 여부

false

-ExcludeFilePath<String[]>

Specifies an array of file paths that the server excludes when it creates the user profile disk.

By default, the server creates the standard file and folder paths, for example, Documents and Music. Use this parameter with or without the ExcludeFolderPath parameter to prevent the server from creating file or folder paths. This parameter overrides any identical values that you specify in the IncludeFilePath or IncludeFolderPath parameters.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-ExcludeFolderPath<String[]>

Specifies an array of folder paths that the server excludes when it creates the user profile disk.

By default, the server creates the standard file and folder paths, for example, Documents and Music. Use this parameter with or without the ExcludeFilePath parameter to prevent the server from creating file or folder paths. This parameter overrides any identical values that you specify in the IncludeFilePath or IncludeFolderPath parameters.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-GrantAdministrativePrivilege<Boolean>

Indicates whether the server grants administrative privileges to the user account that it assigns to a personal virtual desktop. This parameter applies only to personal virtual desktop collections.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

false

와일드카드 문자 허용 여부

false

-IncludeFilePath<String[]>

Specifies an array of file paths that the server includes when it creates the user profile disk.

By default, the server creates the standard file and folder paths, for example, Documents and Music. Use this parameter with or without the IncludeFolderPath parameter to create file or folder paths.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-IncludeFolderPath<String[]>

Specifies an array of folder paths that the server excludes when it creates the user profile disk.

By default, the server creates the standard file and folder paths, for example, Documents and Music. Use this parameter with or without the IncludeFilePath parameter to create file or folder paths.


별칭

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

-MaxUserProfileDiskSizeGB<Int32>

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


별칭

none

필수 여부

true

위치

named

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-RedirectAllMonitors<Boolean>

Indicates whether the server redirects all client monitors to the remote session. Specify $False to redirect a single monitor to the remote session.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-RedirectClientPrinter<Boolean>

Indicates whether the server redirects the client printers to the server printer.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-SaveDelayMinutes<Int32>

Specifies the delay, in minutes, before the server saves a virtual desktop that is not in use.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-UserGroups<String[]>

Specifies an array of user groups that are authorized to connect to the collection.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

<CommonParameters>

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

입력

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

출력

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

  • Null

Example 1: Change the save delay setting for a virtual desktop collection

This command changes the save delay setting for the virtual desktop collection named Virtual Desktop Pool that is associated with the RD Connection Broker server named rdcb.contoso.com. The command specifies a delay of 5 minutes before the server saves a virtual desktop in the virtual desktop collection that is not in use.


PS C:\> Set-RDVirtualDesktopCollectionConfiguration -ConnectionBroker "rdcb.contoso.com" -CollectionName "Virtual Desktop Pool" -SaveDelayMinutes 5

Example 2: Change the user profile disk settings for a virtual desktop collection

This command enables a user profile disk for the virtual desktop collection named Virtual Desktop Pool. The command specifies the maximum size of 10 gigabytes for the user profile disk and specifies the path of the user profile disk.


PS C:\> Set-RDVirtualDesktopCollectionConfiguration -ConnectionBroker "rdcb.contoso.com" -CollectionName "Virtual Desktop Pool" -EnableUserProfileDisks -MaxUserProfileDiskSizeGB 10 -DiskPath "\\RDS-WKS-A27.contoso.com\uvhd"

Example 3: Change settings for a virtual desktop collection

This command changes configuration settings for the virtual desktop collection named Virtual Desktop Pool. The command adds a description to the virtual desktop collection, specifies that the server redirects a single monitor to the remote session, and specifies that Remote Desktop Services redirect AudioVideoPlayBack and PlugAndPlayDevice client devices to the server in this collection.


PS C:\> Set-RDVirtualDesktopCollectionConfiguration -CollectionName "Virtual Desktop Pool" -CollectionDescription "Virtual Desktop Pool created using PowerShell" -RedirectAllMonitors $False -ConnectionBroker "rdcb.contoso.com" -ClientDeviceRedirectionOptions AudioVideoPlayBack,PlugAndPlayDevice

관련 항목

커뮤니티 추가 항목

추가
표시: