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
);

パラメーター

Name [in]

RD CAP の名前。 名前は 64 文字以下で、一意である必要があり (大文字と小文字は無視されます)、次の予約文字を含めることはできません。

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

UserGroupNames [in]

セミコロンで区切られたユーザー グループ名の一覧。 名前は Domain\UserGroupName という形式です。 ユーザーがこれらのユーザー グループのいずれかに属している場合、ユーザーは RD ゲートウェイ サーバーへのアクセスを許可されます。

ComputerGroupNames [in]

セミコロンで区切られたコンピューター グループ名の一覧。 この値は空にすることができます。 名前は Domain\ComputerGroupName という形式です。 値が指定されている場合、ユーザーが RD ゲートウェイ サーバーにアクセスするには、クライアント コンピューターがこれらのコンピューター グループのいずれかに属している必要があります。

SmartCard [in]

スマート カードを使用して RD ゲートウェイ サーバーで認証できるかどうかを指定します。

パスワード [入力]

RD ゲートウェイ サーバーでの認証にパスワードを使用できるかどうかを指定します。

SecureId [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 ゲートウェイ サーバーに接続できるかどうかを示します

戻り値

メソッドが成功すると、0 が返されます。 メソッドが失敗した場合は、0 以外の値を返します。 エラー コードの一覧については、「 リモート デスクトップ サービス WMI プロバイダーのエラー コード」を参照してください。

注釈

このメソッドを呼び出すには、Administrators グループのメンバーである必要があります。

マネージド オブジェクト形式 (MOF) ファイルには、Windows Management Instrumentation (WMI) クラスの定義が含まれています。 MOF ファイルは、Microsoft Windows ソフトウェア開発キット (SDK) の一部としてインストールされません。 サーバー マネージャーを使用して関連付けられたロールを追加すると、サーバーにインストールされます。 MOF ファイルの詳細については、「 マネージド オブジェクト形式 (MOF)」を参照してください。

要件

要件	値
サポートされている最小のクライアント	サポートなし
サポートされている最小のサーバー	Windows Server 2008
名前空間	Root\CIMv2\TerminalServices
MOF	TSGateway.mof
[DLL]	AagWmi.dll

こちらもご覧ください

Win32_TSGatewayConnectionAuthorizationPolicy