Add-RDServer

  • [アーティクル]

適用対象: 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.

Aliases

none

必須/オプション

false

位置

3

既定値

none

パイプライン入力の受け入れ

false

ワイルドカード文字の受け入れ

false

-CreateVirtualSwitch

Indicates that the cmdlet creates a virtual switch.

Aliases

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.

Aliases

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

Aliases

infa

必須/オプション

false

位置

named

既定値

none

パイプライン入力の受け入れ

false

ワイルドカード文字の受け入れ

false

-InformationVariable<System.String>

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

Aliases

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.

Aliases

none

必須/オプション

true

位置

2

既定値

none

パイプライン入力の受け入れ

false

ワイルドカード文字の受け入れ

false

-Server<String>

Specifies the FQDN of the server to add to the Remote Desktop deployment.

Aliases

none

必須/オプション

true

位置

1

既定値

none

パイプライン入力の受け入れ

false

ワイルドカード文字の受け入れ

false

<CommonParameters>

このコマンドレットは共通のパラメーターをサポートしています(-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、および -OutVariable)。詳細については、TechNet の「 「about_CommonParameters」 (https://go.microsoft.com/fwlink/p/?LinkID=113216) を参照してください。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

  • This cmdlet accepts no input.

出力

出力型は、コマンドレットが出力するオブジェクトの型です。

  • 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"

関連項目

Get-RDServer

Remove-RDServer