Set-RDDeploymentGatewayConfiguration

Set-RDDeploymentGatewayConfiguration

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

구문

Parameter Set: Default
Set-RDDeploymentGatewayConfiguration [-GatewayMode] <GatewayUsage> [[-GatewayExternalFqdn] <String> ] [[-LogonMethod] <GatewayAuthMode> ] [[-UseCachedCredentials] <Boolean> ] [[-BypassLocal] <Boolean> ] [[-ConnectionBroker] <String> ] [-Force] [ <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 or not authorized remote users bypass the RD Gateway server for local connections. By default, this parameter is $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.

-Force

사용자 확인을 요구하지 않고 명령을 실행합니다.

-GatewayExternalFqdn<String>

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

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

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

-UseCachedCredentials<Boolean>

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

<CommonParameters>

이 cmdlet은 일반 매개 변수 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer 및 -OutVariable을 지원합니다. 자세한 내용은 다음을 참조하세요. about_CommonParameters(https://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" 

관련 항목

Get-RDDeploymentGatewayConfiguration