Add-RDServer
업데이트 날짜: 2015년 6월
적용 대상: Windows 10, Windows Server Technical Preview
Add-RDServer
Adds an RDS server to a Remote Desktop deployment.
구문
Parameter Set: Default
Add-RDServer [-Server] <String> [-Role] <String> {RDS-CONNECTION-BROKER | RDS-VIRTUALIZATION | RDS-RD-SERVER | RDS-WEB-ACCESS | RDS-GATEWAY | RDS-LICENSING} [[-ConnectionBroker] <String> ] [[-GatewayExternalFqdn] <String> ] [[-CreateVirtualSwitch]] [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [ <CommonParameters>]
자세한 설명
The Add-RDServer cmdlet adds a Remote Desktop Services (RDS) server to a Remote Desktop deployment. Specify a server to add by using a fully qualified domain name (FQDN) and role service name. If you add a Remote Desktop Gateway (RD Gateway) role, specify the FQDN for the external gateway. You can use this cmdlet to create a virtual switch.
매개 변수
-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 FQDN of the local computer.
별칭 |
none |
필수 여부 |
false |
위치 |
3 |
기본값 |
none |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-CreateVirtualSwitch
Indicates that the cmdlet creates a virtual switch.
별칭 |
none |
필수 여부 |
false |
위치 |
5 |
기본값 |
none |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-GatewayExternalFqdn<String>
Specifies the external FQDN of the RD Gateway server for this Remote Desktop deployment. Use this parameter when you are adding the RD Gateway role service. The Role parameter value is RDS-GATEWAY.
별칭 |
none |
필수 여부 |
false |
위치 |
4 |
기본값 |
none |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
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 |
-Role<String>
Specifies an RDS role service name. 이 매개 변수에 허용되는 값은 다음과 같습니다.
-- RDS-VIRTUALIZATION. Remote Desktop Virtualization Host (RD Virtualization Host).
-- RDS-RD-SERVER. Remote Desktop Session Host (RD Session Host).
-- RDS-CONNECTION-BROKER. RD Connection Broker.
-- RDS-WEB-ACCESS. Remote Desktop Web Access (RD Web Access).
-- RDS-GATEWAY. RD Gateway.
-- RDS-LICENSING. Remote Desktop Licensing (RD Licensing).
If you select a value of RDS-GATEWAY for this parameter, supply a value for the GatewayExternalFqdn parameter.
별칭 |
none |
필수 여부 |
true |
위치 |
2 |
기본값 |
none |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-Server<String>
Specifies the FQDN of the server to add to the Remote Desktop deployment.
별칭 |
none |
필수 여부 |
true |
위치 |
1 |
기본값 |
none |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
<CommonParameters>
이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 TechNet의 about_CommonParameters(https://go.microsoft.com/fwlink/p/?LinkID=113216)
입력
입력 형식은 cmdlet으로 파이프할 수 있는 개체의 형식입니다.
- This cmdlet accepts no input.
출력
출력 형식은 cmdlet 실행 시 출력되는 개체의 형식입니다.
- Null
예
Example 1: Add an RD Session Host server
This command adds a server named SessionHost.Contoso.com as an RD Session Host server to a deployment that has an RD Connection Broker server named RDCB.Contoso.com. The RDS-RD-SERVER role indicates an RD Session Host server.
PS C:\> Add-RDServer -Server "SessionHost.Contoso.com" -Role "RDS-RD-SERVER" -ConnectionBroker "RDCB.Contoso.com"
Example 2: Add an RD Virtualization Host server and create a virtual switch
This command adds a server named VirtualizationHost.Contoso.com as an RD Virtualization Host server to a deployment that has an RD Connection Broker server named RDCB.Contoso.com. The command creates a virtual switch.
PS C:\> Add-RDServer -Server "VirtualizationHost.Contoso.com" -Role "RDS-VIRTUALIZATION" -ConnectionBroker "RDCB.Contoso.com" -CreateVirtualSwitch
Example 3: Add an RD Gateway server
This command adds a server named Gateway.Contoso.com as an external gateway to a deployment that has an RD Connection Broker server named RDCB.Contoso.com. The external FQDN of the gateway is ExternalFQDN.NorthWindTraders.com.
PS C:\> Add-RDServer -Server "Gateway.Contoso.com" -Role "RDS-GATEWAY" -ConnectionBroker "RDCB.Contoso.com" -GatewayExternalFqdn "ExternalFQDN.NorthWindTraders.com"
Example 4: Add an RD Connection Broker server
This command adds a server named RDCB02Contoso.com as an RD Connection Broker server to a deployment that has an RD Connection Broker server named RDCB.Contoso.com.
PS C:\> Add-RDServer -Server "RDCB02Contoso.com" -Role "RDS-CONNECTION-BROKER" -ConnectionBroker "RDCB.Contoso.com"