Freigeben über


Create-Methode der Win32_TSGatewayConnectionAuthorizationPolicy-Klasse

Erstellt mithilfe der angegebenen Werte eine Remotedesktop-Verbindungsautorisierungsrichtlinie (RD CAP). Die neue RD-CAP wird oben in der RD CAP-Auswertungsreihenfolge eingefügt, wobei der Order-Eigenschaftswert "1" lautet.

Syntax

uint32 Create(
  [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 mindestens 64 Zeichen lang sein, muss eindeutig sein (Groß-/Kleinschreibung wird ignoriert) und darf die folgenden reservierten Zeichen nicht enthalten:

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

UserGroupNames [in]

Liste der Benutzergruppennamen, getrennt durch Semikolons, für die neue RD-CAP.

ComputerGroupNames [in]

Liste der Computergruppennamen, getrennt durch Semikolons, für die neue RD-CAP.

SmartCard [in]

Gibt an, ob Smartcards zur 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.

DiskDrivesDisabled [in]

Gibt an, ob die Datenträgerumleitung deaktiviert werden soll, wenn der DeviceRedirectionType-Parameter "2" lautet.

DruckerDisabled [in]

Gibt an, ob die Druckerumleitung deaktiviert werden soll, wenn der DeviceRedirectionType-Parameter "2" lautet.

SerialPortsDisabled [in]

Gibt an, ob die Serielle Portumleitung deaktiviert werden soll, wenn der DeviceRedirectionType-Parameter "2" lautet.

ClipboardDisabled [in]

Gibt an, ob die Zwischenablageumleitung deaktiviert werden soll, wenn der DeviceRedirectionType-Parameter "2" lautet.

PlugAndPlayDevicesDisabled [in]

Gibt an, ob die Umleitung von Plug & Play Geräten deaktiviert werden soll, wenn der DeviceRedirectionType-Parameter "2" lautet.

LeerlaufTimeout [in]

Leerlauftimeoutwert in Minuten

SessionTimeout [in]

Sitzungstimeoutwert in Minuten

SessionTimeoutAction [in]

Sitzungstimeoutaktion in Minuten

AllowOnlySDRServers [in]

Ob Verbindungen nur mit SDR TS-Servern zulässig sind

CookieAuthentication [in]

Gibt an, ob die Cookieauthentifizierung zum Herstellen einer Verbindung mit dem TS-Gatewayserver verwendet werden kann.

Rückgabewert

Wenn die Methode erfolgreich ist, wird null zurückgegeben. Wenn die Methode nicht erfolgreich ist, gibt sie einen wert ohne Zero zurück. Eine Liste der Fehlercodes finden Sie unter WMI-Anbieterfehlercodes 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 des Server-Manager hinzufügen. Weitere Informationen zu MOF-Dateien finden Sie unter Verwaltetes Objektformat (MOF).

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Nicht unterstützt
Unterstützte Mindestversion (Server)
WindowsServer 2008
Namespace
Root\CIMv2\TerminalServices
MOF
TSGateway.mof
DLL
AagWmi.dll

Siehe auch

Win32_TSGatewayConnectionAuthorizationPolicy