Win32_TSGatewayServerSettings 클래스

아티클
06/13/2023

RD 게이트웨이(원격 데스크톱 게이트웨이) 서버 설정을 보고 구성하는 메서드와 속성을 제공합니다. 관리자는 이 클래스를 사용하여 프로토콜 집합, 이벤트 로그에 기록될 이벤트 집합 및 RD 게이트웨이를 통한 최대 연결 수를 구성할 수 있습니다.

구문

[dynamic, provider("AAGProvider"), AMENDMENT]
class Win32_TSGatewayServerSettings
{
  uint32  MaxConnections;
  boolean UnlimitedConnections;
  uint32  MaximumAllowedConnectionsBySku;
  string  SkuName;
  uint32  MaxProtocols;
  uint32  MaxLogEvents;
  string  adminMessageText;
  string  adminMessageStartTime;
  string  adminMessageEndTime;
  string  consentMessageText;
  boolean OnlyConsentCapableClients;
  boolean CentralCAPEnabled;
  boolean RequestSOH;
  string  AuthenticationPluginName;
  string  AuthenticationPluginCLSID;
  string  AuthenticationPluginDescription;
  string  AuthorizationPluginName;
  string  AuthorizationPluginCLSID;
  string  AuthorizationPluginDescription;
  uint32  SslBridging;
  boolean IsConfigured;
  uint8   CertHash[];
  boolean EnforceChannelBinding;
};

멤버

Win32_TSGatewayServerSettings 클래스에는 다음과 같은 유형의 멤버가 있습니다.

메서드
속성

메서드

Win32_TSGatewayServerSettings 클래스에는 이러한 메서드가 있습니다.

메서드	설명
구성	RD 게이트웨이 서비스에 필요한 IIS 및 RPC 설정을 구성합니다. Windows Server 2008: 이 메서드는 Windows Server 2008 R2 이전에는 사용할 수 없습니다.
EnableCentralCAP	중앙 RD CAP(원격 데스크톱 연결 권한 부여 정책) 서버가 이 서버에 대한 연결 권한 부여 정책을 제어하는 데 사용되는지 여부를 제어하는 CentralCAPEnabled 속성을 사용하거나 사용하지 않도록 설정합니다.
EnableLogEvent	지정된 이벤트 형식의 로깅을 사용하거나 사용하지 않도록 설정합니다.
EnableOnlyConsentCapableClients	OnlyConsentCapableClients 속성을 설정합니다. Windows Server 2008: 이 메서드는 Windows Server 2008 R2 이전에는 사용할 수 없습니다.
EnableRequestSOH	이 메서드는 Windows Server 2016 부터 지원되지 않습니다. Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 및 Windows Server 2008: SoH(Health 문)에 대한 요청을 사용하거나 사용하지 않도록 설정합니다.
EnableTransport	지정된 전송을 사용하거나 사용하지 않도록 설정합니다. Windows Server 2008 R2 및 Windows Server 2008: 이 메서드는 Windows Server 2012 전에 사용할 수 없습니다.
EnumAuthenticationPlugins	등록된 모든 인증 플러그 인을 열거합니다. Windows Server 2008: 이 메서드를 사용할 수 없습니다.
EnumAuthorizationPlugins	등록된 모든 권한 부여 플러그 인을 열거합니다. Windows Server 2008: 이 메서드는 Windows Server 2008 R2 이전에는 사용할 수 없습니다.
GetIPAndPort	지정된 전송에 대한 수신 대기 IP 주소 및 포트 번호를 가져옵니다. Windows Server 2008 R2 및 Windows Server 2008: 이 메서드는 Windows Server 2012 전에 사용할 수 없습니다.
GetLogEventName	지정된 로그 이벤트 인덱스 로그 이벤트 이름을 반환합니다.
GetProtocolName	지정된 프로토콜 인덱스 프로토콜 이름을 반환합니다.
IsLogEventEnabled	지정된 이벤트 로그 형식을 사용할 수 있는지 여부를 나타냅니다.
IsTransportEnabled	지정된 전송을 사용할 수 있는지 여부를 결정합니다. Windows Server 2008 R2 및 Windows Server 2008: 이 메서드는 Windows Server 2012 전에 사용할 수 없습니다.
QueryCertContext	지정된 인증서가 설치되어 있는지 여부를 나타냅니다.
RecycleRpcApplicationPools	IIS에서 RPC 애플리케이션 풀을 재활용합니다. Windows Server 2008: 이 메서드는 Windows Server 2008 R2 이전에는 사용할 수 없습니다.
RefreshCertContext	RD 게이트웨이 서버에서 사용하는 인증서를 새로 고칩니다.
SetAuthenticationPlugin	RD 게이트웨이 서버에 대한 현재 인증 플러그 인을 설정합니다. Windows Server 2008: 이 메서드는 Windows Server 2008 R2 이전에는 사용할 수 없습니다.
SetAuthenticationPluginAndRecycleRpcApplicationPools	RD 게이트웨이 서버에 대한 현재 인증 플러그 인을 설정하고 IIS에서 RPC 애플리케이션 풀을 재활용합니다. Windows Server 2008: 이 메서드는 Windows Server 2008 R2 이전에는 사용할 수 없습니다.
SetAuthorizationPlugin	RD 게이트웨이 서버에 대한 현재 권한 부여 플러그 인을 설정합니다. Windows Server 2008: 이 메서드는 Windows Server 2008 R2 이전에는 사용할 수 없습니다.
SetCertificate	IIS의 포트 443에서 HTTPS 바인딩에 대한 인증서 해시를 설정합니다. Windows Server 2008: 이 메서드는 Windows Server 2008 R2 이전에는 사용할 수 없습니다.
SetCertificateACL	이 서버에 대한 ACL(인증서 액세스 제어 목록)을 설정합니다.
SetDefaultPluginsAndRecycleRpcApplicationPools	RD 게이트웨이 서버에 대한 현재 인증 및 권한 부여 플러그 인을 설정하고 IIS에서 RPC 애플리케이션 풀을 재활용합니다. Windows Server 2008: 이 메서드는 Windows Server 2008 R2 이전에는 사용할 수 없습니다.
SetEnforceChannelBinding	EnforceChannelBinding 속성을 설정합니다. Windows Server 2008 R2 및 Windows Server 2008: 이 메서드는 Windows Server 2012 전에 사용할 수 없습니다.
SetIPAndPort	지정된 전송에 대한 수신 대기 IP 주소 및 포트 번호를 설정합니다. Windows Server 2008 R2 및 Windows Server 2008: 이 메서드는 Windows Server 2012 전에 사용할 수 없습니다.
SetMaxConnections	RD 게이트웨이를 통해 허용되는 최대 연결 수를 설정합니다. 이 메서드는 MaxConnections 및 UnlimitedConnections 속성을 변경합니다.
SetSslBridging	RD 게이트웨이 서버에서 사용할 SSL 브리징 유형을 설정합니다. Windows Server 2008: 이 메서드는 Windows Server 2008 R2 이전에는 사용할 수 없습니다.
TSGRemoveAdminMsg	게이트웨이 서버에 대한 관리 메시지를 제거합니다. Windows Server 2008: 이 메서드는 Windows Server 2008 R2 이전에는 사용할 수 없습니다.
TSGRemoveConsentMsg	게이트웨이 서버에 대한 관리 메시지를 제거합니다. Windows Server 2008: 이 메서드는 Windows Server 2008 R2 이전에는 사용할 수 없습니다.
TSGStoreAdminMsg	게이트웨이 서버에 대한 관리 메시지를 업데이트. Windows Server 2008: 이 메서드는 Windows Server 2008 R2 이전에는 사용할 수 없습니다.
TSGStoreConsentMsg	게이트웨이 서버에 대한 동의 메시지를 업데이트. Windows Server 2008: 이 메서드는 Windows Server 2008 R2 이전에는 사용할 수 없습니다.

속성

Win32_TSGatewayServerSettings 클래스에는 이러한 속성이 있습니다.

adminMessageEndTime

데이터 형식: 문자열
액세스 형식: 읽기 전용

관리 메시지 종료 시간입니다.

Windows Server 2008: 이 속성은 Windows Server 2008 R2 이전에는 사용할 수 없습니다.

adminMessageStartTime

데이터 형식: 문자열
액세스 형식: 읽기 전용

관리 메시지 시작 시간입니다.

Windows Server 2008: 이 속성은 Windows Server 2008 R2 이전에는 사용할 수 없습니다.

adminMessageText

데이터 형식: 문자열
액세스 형식: 읽기 전용

관리 메시지 텍스트입니다.

Windows Server 2008: 이 속성은 Windows Server 2008 R2 이전에는 사용할 수 없습니다.

AuthenticationPluginCLSID

데이터 형식: 문자열
액세스 형식: 읽기 전용

현재 인증 플러그 인의 CLSID입니다.

Windows Server 2008: 이 속성은 Windows Server 2008 R2 이전에는 사용할 수 없습니다.

AuthenticationPluginDescription

데이터 형식: 문자열
액세스 형식: 읽기 전용

현재 인증 플러그 인에 대한 설명입니다.

Windows Server 2008: 이 속성은 Windows Server 2008 R2 이전에는 사용할 수 없습니다.

AuthenticationPluginName

데이터 형식: 문자열
액세스 형식: 읽기 전용

현재 인증 플러그 인의 이름입니다.

Windows Server 2008: 이 속성은 Windows Server 2008 R2 이전에는 사용할 수 없습니다.

AuthorizationPluginCLSID

데이터 형식: 문자열
액세스 형식: 읽기 전용

현재 권한 부여 플러그 인의 CLSID입니다.

Windows Server 2008: 이 속성은 Windows Server 2008 R2 이전에는 사용할 수 없습니다.

AuthorizationPluginDescription

데이터 형식: 문자열
액세스 형식: 읽기 전용

현재 권한 부여 플러그 인에 대한 설명입니다.

Windows Server 2008: 이 속성은 Windows Server 2008 R2 이전에는 사용할 수 없습니다.

AuthorizationPluginName

데이터 형식: 문자열
액세스 형식: 읽기 전용

현재 권한 부여 플러그 인의 이름입니다.

Windows Server 2008: 이 속성은 Windows Server 2008 R2 이전에는 사용할 수 없습니다.

CentralCAPEnabled

데이터 형식: boolean
액세스 형식: 읽기 전용

중앙 RD CAP 서버가 이 서버를 제어하는 데 사용되는지 여부를 지정합니다. 이 속성은 EnableCentralCAP 메서드를 호출하여 변경할 수 있습니다.

CertHash

데이터 형식: uint8 배열
액세스 형식: 읽기 전용

IIS의 포트 443에서 HTTPS 바인딩에 대한 인증서 해시를 지정합니다.

Windows Server 2008: 이 속성은 Windows Server 2008 R2 이전에는 사용할 수 없습니다.

consentMessageText

데이터 형식: 문자열
액세스 형식: 읽기 전용

동의 메시지 텍스트입니다.

Windows Server 2008: 이 속성은 Windows Server 2008 R2 이전에는 사용할 수 없습니다.

EnforceChannelBinding

데이터 형식: boolean
액세스 형식: 읽기 전용

HTTP 전송에 채널 바인딩이 적용되는지 나타냅니다. SetEnforceChannelBinding 메서드를 사용하여 이 속성 값을 변경할 수 있습니다.

Windows Server 2008 R2 및 Windows Server 2008: 이 속성은 Windows Server 2012 전에 사용할 수 없습니다.

구성됨

데이터 형식: boolean
액세스 형식: 읽기 전용

RD 게이트웨이 서비스에 필요한 IIS 및 RPC 설정을 구성할지 지정합니다.

Windows Server 2008: 이 속성은 Windows Server 2008 R2 이전에는 사용할 수 없습니다.

MaxConnections

데이터 형식: uint32
액세스 형식: 읽기 전용
한정자: 키

RD 게이트웨이를 통해 허용되는 최대 연결 수를 반환합니다. 이 속성은 SetMaxConnections 메서드를 사용하여 설정할 수 있습니다.

MaximumAllowedConnectionsBySku

데이터 형식: uint32
액세스 형식: 읽기 전용

SKU(Stock-Keeping Unit)에서 허용하는 최대 연결 수입니다.

MaxLogEvents

데이터 형식: uint32
액세스 형식: 읽기 전용

최대 로그 이벤트 수를 반환합니다.

MaxProtocols

데이터 형식: uint32
액세스 형식: 읽기 전용

RD 게이트웨이에서 지원하는 프로토콜 수입니다.

OnlyConsentCapableClients

데이터 형식: boolean
액세스 형식: 읽기 전용

동의 메시지를 사용할 수 있는 클라이언트만 RD 게이트웨이에 연결할 수 있는지를 지정합니다.

Windows Server 2008: 이 속성은 Windows Server 2008 R2 이전에는 사용할 수 없습니다.

0이 아닌 값

동의 메시지 지원 클라이언트만 연결할 수 있습니다.

0

동의 메시지를 사용할 수 없는 클라이언트도 연결할 수 있습니다.

RequestSOH

데이터 형식: boolean
액세스 형식: 읽기 전용

이 속성은 Windows Server 2016 시작해도 지원되지 않습니다.

**Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 및 Windows Server 2008: **

서버가 클라이언트에서 SoH(Health 문)를 요청해야 하는지 여부를 지정합니다. 이 속성은 EnableRequestSOH 메서드를 사용하여 변경할 수 있습니다.

SkuName

데이터 형식: 문자열
액세스 형식: 읽기 전용

SKU 이름입니다.

SslBridging

데이터 형식: uint32
액세스 형식: 읽기 전용

RD 게이트웨이 서버에서 사용할 SSL 브리징 유형을 지정합니다. 다음 값 중 하나일 수 있습니다.

Windows Server 2008: 이 속성은 Windows Server 2008 R2 이전에는 사용할 수 없습니다.

SSL 브리징이 없습니다.

HTTPS에서 HTTP 브리징으로.

HTTPS에서 HTTPS 브리징으로.

UnlimitedConnections

데이터 형식: boolean
액세스 형식: 읽기 전용

RD 게이트웨이를 통해 무제한의 연결이 허용되는지 여부를 나타냅니다. SetMaxConnections 메서드를 사용하여 이 속성을 설정할 수 있습니다.

설명

이 클래스를 사용하려면 Administrators 그룹의 구성원이어야 합니다.

MOF(Managed Object Format) 파일에는 WMI(Windows Management Instrumentation) 클래스에 대한 정의가 포함되어 있습니다. MOF 파일은 Microsoft Windows SDK(소프트웨어 개발 키트)의 일부로 설치되지 않습니다. 서버 관리자 사용하여 연결된 역할을 추가할 때 서버에 설치됩니다. MOF 파일에 대한 자세한 내용은 MOF(관리 개체 형식)를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	지원되는 버전 없음
지원되는 최소 서버	Windows Server 2008
네임스페이스	Root\CIMv2\TerminalServices
MOF	TSGateway.mof
DLL	AagWmi.dll

추가 정보

Win32_TSGatewayConnection
Win32_TSGatewayConnectionAuthorizationPolicy
Win32_TSGatewayLoadBalancer
Win32_TSGatewayRADIUSServer
Win32_TSGatewayResourceAuthorizationPolicy
Win32_TSGatewayResourceGroup

다음을 통해 공유

Win32_TSGatewayServerSettings 클래스

구문

멤버

메서드

속성

설명

요구 사항

추가 정보

피드백

추가 리소스