共用方式為

Win32_TSGatewayConnectionAuthorizationPolicy 類別的 Update 方法

  • 發行項

更新目前的遠端桌面連線授權原則 (RD CAP) 。

語法

uint32 Update(
  [in] string  Name,
  [in] string  UserGroupNames,
  [in] string  ComputerGroupNames,
  [in] boolean SmartCard,
  [in] boolean Password,
  [in] boolean SecureId,
  [in] boolean Enabled,
  [in] uint32  DeviceRedirectionType,
  [in] boolean DiskDrivesDisabled,
  [in] boolean PrintersDisabled,
  [in] boolean SerialPortsDisabled,
  [in] boolean ClipboardDisabled,
  [in] boolean PlugAndPlayDevicesDisabled,
  [in] uint32  IdleTimeout,
  [in] uint32  SessionTimeout,
  [in] uint32  SessionTimeoutAction,
  [in] boolean AllowOnlySDRServers,
  [in] boolean CookieAuthentication
);

參數

名稱 [in]

RD CAP 的名稱。 名稱必須是 64 個字元或更少、唯一的 (大小寫會忽略) ，而且不能包含下列保留字元：

<> : ; " / \ | ? * [TAB]

UserGroupNames [in]

分號分隔的使用者組名清單。 名稱的格式為 Domain\UserGroupName。 如果使用者屬於其中任何一個使用者群組，使用者將可存取 RD 閘道伺服器。

ComputerGroupNames [in]

分號分隔的電腦群組名清單。 此值可以是空的。 名稱的格式為 Domain\ComputerGroupName。 如果指定值，用戶端電腦必須屬於其中一個電腦群組，使用者才能存取 RD 閘道伺服器。

智慧卡 [in]

指定智慧卡是否可以用來向 RD 閘道伺服器進行驗證。

密碼 [in]

指定密碼是否可以用來向 RD 閘道伺服器進行驗證。

SecureId [in]

這個參數保留給未來使用。

已啟用 [in]

指定是否啟用此 RD CAP。

DeviceRedirectionType [in]

指定將重新導向哪些裝置類型。

0

所有裝置都會重新導向。

1

不會重新導向任何裝置。

2

指定的裝置將不會重新導向。 DiskDrivesDisabled、PrintersDisabled、SerialPortsDisabled、ClipboardDisabled和PlugAndPlayDevicesDisabled參數可控制不會重新導向哪些裝置。

DiskDrivesDisabled [in]

指定如果 DeviceRedirectionType 參數為 「2」，是否要停用磁片磁碟機重新導向。

PrintersDisabled [in]

指定如果 DeviceRedirectionType 參數為 「2」，是否停用印表機重新導向。

SerialPortsDisabled [in]

指定如果 DeviceRedirectionType 參數為 「2」，是否停用序列埠重新導向。

ClipboardDisabled [in]

指定如果 DeviceRedirectionType 參數為 「2」，是否停用剪貼簿重新導向。

PlugAndPlayDevicesDisabled [in]

指定如果DeviceRedirectionType參數為 「2」，是否要停用隨插即用裝置的重新導向。

IdleTimeout [in]

以分鐘為單位的閒置逾時值

SessionTimeout [in]

以分鐘為單位的會話逾時值

SessionTimeoutAction [in]

以分鐘為單位的會話逾時動作

AllowOnlySDRServers [in]

是否只允許連線到 SDR TS 伺服器

CookieAuthentication [in]

指出是否可以使用 Cookie 驗證來連線到 TS 閘道伺服器

傳回值

如果方法成功，則會傳回零。 如果方法不成功，它會傳回非零值。 如需錯誤碼的清單，請參閱 遠端桌面服務 WMI 提供者錯誤碼。

備註

您必須是 Administrators 群組的成員，才能呼叫此方法。

Managed 物件格式 (MOF) 檔案包含 Windows Management Instrumentation (WMI) 類別的定義。 MOF 檔案不會安裝為 Microsoft Windows 軟體發展工具組的一部分， (SDK) 。 當您使用 伺服器管理員 新增相關聯的角色時，它們會安裝在伺服器上。 如需 MOF 檔案的詳細資訊，請參閱 Managed Object Format (MOF) 。

規格需求

需求 值
最低支援的用戶端
 都不支援
最低支援的伺服器
 Windows Server 2008
命名空間
 Root\CIMv2\TerminalServices
MOF
TSGateway.mof
DLL
AagWmi.dll

另請參閱

Win32_TSGatewayConnectionAuthorizationPolicy