Update-Methode der Win32_TSGatewayConnectionAuthorizationPolicy-Klasse

Updates die aktuelle Remotedesktopverbindungsautorisierungsrichtlinie (RD CAP).

Syntax

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

Parameter

Name [in]

Name der RD-CAP. Der Name muss maximal 64 Zeichen lang sein, eindeutig sein (Groß-/Kleinschreibung wird ignoriert) und darf die folgenden reservierten Zeichen nicht enthalten:

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

UserGroupNames [in]

Liste der durch Semikolons getrennten Benutzergruppennamen. Die Namen haben das Format Domain\UserGroupName. Wenn der Benutzer einer dieser Benutzergruppen angehört, wird dem Benutzer der Zugriff auf den RD-Gatewayserver gewährt.

ComputerGroupNames [in]

Liste der durch Semikolons getrennten Computergruppennamen. Dieser Wert kann leer sein. Die Namen haben das Format Domain\ComputerGroupName. Wenn ein Wert angegeben wird, muss der Clientcomputer zu einer dieser Computergruppen gehören, damit der Benutzer auf den RD-Gatewayserver zugreifen kann.

SmartCard [in]

Gibt an, ob Smartcards für die Authentifizierung beim RD-Gatewayserver verwendet werden können.

Kennwort [in]

Gibt an, ob Kennwörter für die Authentifizierung beim RD-Gatewayserver verwendet werden können.

SecureId [in]

Dieser Parameter ist für die zukünftige Verwendung reserviert.

Aktiviert [in]

Gibt an, ob diese RD-CAP aktiviert ist.

DeviceRedirectionType [in]

Gibt an, welche Gerätetypen umgeleitet werden.

0

Alle Geräte werden umgeleitet.

1

Es werden keine Geräte umgeleitet.

2

Angegebene Geräte werden nicht umgeleitet. Die Parameter DiskDrivesDisabled, PrintersDisabled, SerialPortsDisabled, ClipboardDisabled und PlugAndPlayDevicesDisabled steuern, welche Geräte nicht umgeleitet werden.

Rückgabewert

Wenn die Methode erfolgreich ist, wird null zurückgegeben. Wenn die Methode nicht erfolgreich ist, wird ein Wert ungleich 0 (null) zurückgegeben. Eine Liste der Fehlercodes finden Sie unter Fehlercodes des WMI-Anbieters für Remotedesktopdienste.

Bemerkungen

Sie müssen Mitglied der Gruppe Administratoren sein, um diese Methode aufrufen zu können.

MOF-Dateien (Managed Object Format) enthalten die Definitionen für WMI-Klassen (Windows Management Instrumentation). MOF-Dateien werden nicht als Teil des Microsoft Windows Software Development Kit (SDK) installiert. Sie werden auf dem Server installiert, wenn Sie die zugeordnete Rolle mithilfe der Server-Manager hinzufügen. Weitere Informationen zu MOF-Dateien finden Sie unter Managed Object Format (MOF).

Anforderungen

Siehe auch

Win32_TSGatewayConnectionAuthorizationPolicy