New-RDSessionCollection

업데이트 날짜: 2015년 6월

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

New-RDSessionCollection

Creates a session collection of RD Session Host servers.

구문

Parameter Set: PersonalSessionCollection
New-RDSessionCollection [-CollectionName] <System.String> -PersonalSessionCollection -SessionHost <System.String[]> [-AutoAssignUser] [-CollectionDescription <System.String> ] [-ConnectionBroker <System.String> ] [-GrantAdministrativePrivilege] [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [ <CommonParameters>]

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

자세한 설명

The New-RDSessionCollection cmdlet creates a session collection that 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.

매개 변수

-AutoAssignUser

Indicates that this cmdlet enables automatic session desktop assignments for a personal session collection.

-CollectionDescription<System.String>

Specifies a description of a session collection.

-CollectionName<System.String>

Specifies a name for a session collection.

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

-GrantAdministrativePrivilege

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.

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

-PersonalSessionCollection

Indicates that this cmdlet creates a personal session desktop collection.

-SessionHost<System.String[]>

Specifies an array of RD Session Host servers to include in the session collection.

<CommonParameters>

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

입력

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

출력

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

• Microsoft.RemoteDesktopServices.Management.RDSessionCollection

예

Example 1: Create a session collection

This command creates a session collection named Session Collection 02 in the Remote Desktop deployment that has the RD Connection Broker server named RDCB.Contoso.com. The collection includes the RD Session Host servers named RDSH01.Contoso.com and RDSH02.Contoso.com. The command specifies a description of the new 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"

관련 항목

Get-RDSessionCollection

Remove-RDSessionCollection