Set-RDDeploymentGatewayConfiguration

업데이트 날짜: 2015년 6월

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

Set-RDDeploymentGatewayConfiguration

Specifies settings for the RD Gateway server for a Remote Desktop deployment.

구문

Parameter Set: Default
Set-RDDeploymentGatewayConfiguration [-GatewayMode] <GatewayUsage> {DoNotUse | Custom | Automatic} [[-GatewayExternalFqdn] <String> ] [[-LogonMethod] <GatewayAuthMode> {Password | Smartcard | AllowUserToSelectDuringConnection} ] [[-UseCachedCredentials] <Boolean> ] [[-BypassLocal] <Boolean> ] [[-ConnectionBroker] <String> ] [-Force] [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [ <CommonParameters>]




자세한 설명

The Set-RDDeploymentGatewayConfiguration cmdlet specifies settings for the Remote Desktop Gateway (RD Gateway) server for a Remote Desktop deployment. These settings include whether to use the RD Gateway server, user authentication methods, and other connection and authentication options. The RD Gateway role service enables authorized users to connect to virtual desktops, RemoteApp programs, and session-based desktops on an internal corporate network from any Internet-connected device.

매개 변수

-BypassLocal<Boolean>

Indicates whether authorized remote users bypass the RD Gateway server for local connections. By default, the value of this parameter is $False.


별칭

none

필수 여부

false

위치

5

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-ConnectionBroker<String>

Specifies the Remote Desktop Connection Broker (RD Connection Broker) server for this Remote Desktop deployment. If this parameter does not appear, the default value is the fully qualified domain name (FQDN) of the local host.


별칭

none

필수 여부

false

위치

6

기본값

none

파이프라인 입력 허용 여부

false

와일드카드 문자 허용 여부

false

-Force

사용자에게 확인 메시지를 표시하지 않고 명령을 강제 실행합니다.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

false

와일드카드 문자 허용 여부

false

-GatewayExternalFqdn<String>

Specifies the external FQDN of the RD Gateway server for this Remote Desktop deployment.


별칭

none

필수 여부

false

위치

2

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-GatewayMode<GatewayUsage>

Specifies a value that indicates whether or not authorized remote users use the RD Gateway server and, if so, whether they detect existing RD Gateway settings automatically or enter settings manually. 이 매개 변수에 허용되는 값은 다음과 같습니다.

-- DoNotUse: Remote users enter settings manually and do not use the Gateway.
-- Custom: Remote users get Gateway settings from other parameters to this cmdlet.
-- Automatic: Remote users detect Gateway settings automatically.


별칭

none

필수 여부

true

위치

1

기본값

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

-LogonMethod<GatewayAuthMode>

Specifies the method for authenticating user access to the RD Gateway server. 이 매개 변수에 허용되는 값은 다음과 같습니다.

-- GatewayAuthMode: Users authenticate by using the method that the Gateway specifies (using a smart card reader or a password).

-- AllowUserToSelectDuringConnection: The Gateway prompts users to authenticate access when they connect. They must specify a password or smart card reader as the authentication method.


별칭

none

필수 여부

false

위치

3

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-UseCachedCredentials<Boolean>

Indicates whether or not remote users can use RD Gateway access credentials to authenticate access to the remote computer.


별칭

none

필수 여부

false

위치

4

기본값

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



    None


Example 1: Specify settings to configure RD Gateway access

This command sets these options for the RD Gateway server:

-- Authorized users automatically detect settings from the RD Gateway server.

-- The RD Gateway server has an FQDN of rdcb.contoso.com.

-- Remote users authenticate access when they connect, use RD Gateway access credentials to authenticate access to the remote computer, and bypass the RD Gateway server for local connections.

-- The cmdlet also specifies rdcb.contoso.com as the RD Connection Broker server.


PS C:\> Set-RDDeploymentGatewayConfiguration -GatewayMode Automatic -GatewayExternalFQDN "rdg.contoso.com" -LogonMethod AllowUserToSelectDuringConnection -UseCachedCredentials $True -BypassLocal $True -ConnectionBroker "rdcb.contoso.com" 

관련 항목

커뮤니티 추가 항목

추가
표시: