Freigeben über

Win32_TSDeploymentSettings-Klasse

  • Artikel

Definiert die Standardeinstellungen, die remoteApp Manager beim Erstellen von RDP-Dateien (Remotedesktopprotokoll) verwendet. Diese Einstellungen wirken sich nicht auf veröffentlichte Anwendungen oder Desktops aus.

Syntax

class Win32_TSDeploymentSettings : CIM_LogicalElement
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  sint32   Port;
  string   FarmName;
  sint32   GatewayUsage;
  string   GatewayName;
  sint32   GatewayAuthMode;
  boolean  GatewayUseCachedCreds;
  boolean  RequireServerAuth;
  sint32   ColorBitDepth;
  boolean  AllowFontSmoothing;
  boolean  UseMultimon;
  sint32   RedirectionOptions;
  boolean  HasCertificate;
  uint8    CertificateHash[];
  string   CertificateIssuedTo;
  string   CertificateIssuedBy;
  string   CertificateExpiresOn;
  string   CustomRDPSettings;
  string   DeploymentRDPSettings;
};

Member

Die Win32_TSDeploymentSettings-Klasse verfügt über folgende Membertypen:

Eigenschaften

Die Win32_TSDeploymentSettings-Klasse verfügt über diese Eigenschaften.

AllowFontSmoothing

Datentyp: boolean

Zugriffstyp: Lese-/Schreibzugriff

Gibt an, ob die Schriftglättung zugelassen werden soll.

Caption

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: MaxLen (64)

Kurze Beschreibung (einzeilige Zeichenfolge) des Objekts.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

CertificateExpiresOn

Datentyp: string

Zugriffstyp: Lese-/Schreibzugriff

Das Datum, an dem das Zertifikat abläuft. Dieser Wert wird als 64-Bit FILETIME-Format gespeichert.

CertificateHash

Datentyp: uint8-Array

Zugriffstyp: Lese-/Schreibzugriff

Der Fingerabdruck des Zertifikats, das zum Signieren von RDP-Dateien verwendet wird.

CertificateIssuedBy

Datentyp: string

Zugriffstyp: Lese-/Schreibzugriff

Gibt an, von wem das Zertifikat ausgestellt wird.

CertificateIssuedTo

Datentyp: string

Zugriffstyp: Lese-/Schreibzugriff

Gibt an, an wen das Zertifikat ausgestellt wird.

ColorBitDepth

Datentyp: sint32

Zugriffstyp: Lese-/Schreibzugriff

Die Farbbittiefe der Anzeige. Mögliche Werte sind 4, 8, 15, 16, 24 und 32.

CustomRDPSettings

Datentyp: string

Zugriffstyp: Lese-/Schreibzugriff

Der Inhalt der RDP-Datei, die den benutzerdefinierten RDP-Einstellungen in RemoteApp Manager entspricht.

DeploymentRDPSettings

Datentyp: string

Zugriffstyp: Lese-/Schreibzugriff

Der Inhalt der RDP-Datei, die den Bereitstellungseinstellungen in RemoteApp Manager entspricht. Wenn dieser Wert festgelegt ist, ersetzen die RDP-Bereitstellungseinstellungen die Standardeinstellungen in dieser Klasse. Wenn Sie beispielsweise die GatewayAuthMode-Eigenschaft in dieser Klasse und die DeploymentRDPSettings-Eigenschaft festlegen, wird die GatewayAuthMode-Eigenschaft aus dieser Klasse ignoriert, und der GatewayAuthMode-Wert aus DeploymentRDPSettings wird verwendet.

Beschreibung

Datentyp: string

Zugriffstyp: Schreibgeschützt

Eine Beschreibung des Objekts.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

FarmName

Datentyp: string

Zugriffstyp: Lese-/Schreibzugriff

Der Name des RD-Sitzungshostservers oder der vollqualifizierte Domänenname (FQDN) der Rd-Sitzungshostserverfarm.

GatewayAuthMode

Datentyp: sint32

Zugriffstyp: Lese-/Schreibzugriff

Die RD-Gatewayauthentifizierungsmethode. Die folgenden Werte sind möglich.

0

Kennwort

1

Smartcard

4

Zulassen, dass Benutzer während der Verbindung auswählen können.

GatewayName

Datentyp: string

Zugriffstyp: Lese-/Schreibzugriff

Der Name des zu verwendenden RD-Gatewayservers.

GatewayUsage

Datentyp: sint32

Zugriffstyp: Lese-/Schreibzugriff

Gibt an, ob ein RD-Gatewayserver verwendet werden soll, um über eine Firewall eine Verbindung mit dem Ziel-RD-Sitzungshostserver herzustellen. Die folgenden Werte sind möglich.

0

Verwenden Sie keinen RD-Gatewayserver.

1

Verwenden Sie einen RD-Gatewayserver. Umgehen Sie den RD-Gatewayserver für lokale Adressen.

2

Verwenden Sie einen RD-Gatewayserver.

3

Automatisches Erkennen von RD-Gatewayservereinstellungen.

GatewayUseCachedCreds

Datentyp: boolean

Zugriffstyp: Lese-/Schreibzugriff

Verwenden Sie nach Möglichkeit dieselben Benutzeranmeldeinformationen für den RD-Gatewayserver und den RD-Sitzungshostserver.

HasCertificate

Datentyp: boolean

Zugriffstyp: Lese-/Schreibzugriff

Gibt an, ob ein Zertifikat zum Signieren der RDP-Dateien verwendet werden soll.

InstallDate

Datentyp: datetime

Zugriffstyp: Schreibgeschützt

Qualifizierer: Zuordnungszeichenfolgen ("MIF. DMTF| ComponentID|001.5")

Das Datum, an dem das Objekt installiert wurde. Ein fehlender Wert gibt nicht an, dass das Objekt nicht installiert ist.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Name

Datentyp: string

Zugriffstyp: Schreibgeschützt

Der Name des Objekts.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Port

Datentyp: sint32

Zugriffstyp: Lese-/Schreibzugriff

Der zu verwendende RDP-Port.

RedirectionOptions

Datentyp: sint32

Zugriffstyp: Lese-/Schreibzugriff

Gibt die Optionen für die Geräte- und Ressourcenumleitung für RemoteApp-Verbindungen an. Flags für RedirectionOptions können kombiniert werden. Die folgenden Werte sind möglich.

0

Keine Geräte- oder Ressourcenumleitung.

1

Umleiten von Datenträgerlaufwerken.

2

Drucker umleiten.

4

Leiten Sie die Zwischenablage um.

8

Unterstützte Plug & Play-Geräte umleiten.

16

Umleiten von Smartcards.

32

Audio umleiten.

64

Serielle Ports umleiten.

RequireServerAuth

Datentyp: boolean

Zugriffstyp: Lese-/Schreibzugriff

Gibt an, ob die Serverauthentifizierung erforderlich ist.

Status

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: MaxLen (10)

Aktuelle status des Objekts. Es können verschiedene betriebsbezogene und nicht operative Status definiert werden. Zu den Betriebsstatus gehören: "OK", "Heruntergestuft" und "Pred Fail" (ein Element, z. B. eine SMART-fähige Festplatte, funktioniert möglicherweise ordnungsgemäß, sagt aber in naher Zukunft einen Fehler voraus). Zu den nicht betriebsbereiten Status gehören: "Fehler", "Wird gestartet", "Wird beendet" und "Dienst". Letzteres, "Dienst", kann beim Spiegel-Resilvering eines Datenträgers, beim Erneutladen einer Benutzerberechtigungsliste oder bei anderen administrativen Aufgaben gelten. Nicht alle derartigen Arbeiten sind online, aber das verwaltete Element ist weder "OK" noch in einem der anderen Zustände.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

("OK")

("Fehler")

("Heruntergestuft")

("Unbekannt")

("Pred Fail")

("Wird gestartet")

("Wird beendet")

("Dienst")

UseMultimon

Datentyp: boolean

Zugriffstyp: Lese-/Schreibzugriff

Gibt an, ob mehrere Monitore für den Desktop aktiviert sind.

Bemerkungen

Sie müssen Mitglied der Gruppe Administratoren sein, um Eigenschaften mithilfe dieser Klasse festzulegen.

Wenn RequireServerAuth auf TRUE festgelegt ist, sollten Sie Folgendes berücksichtigen:

  • Wenn das RemoteApp-Programm für das Intranet vorgesehen ist und auf allen Clientcomputern entweder Windows Server 2008 oder Windows Vista ausgeführt wird, müssen Sie den RD-Sitzungshostserver nicht für die Verwendung eines SSL-Zertifikats konfigurieren. In diesem Fall wird die Authentifizierung auf Netzwerkebene verwendet.
  • Sie müssen den FQDN des Servers oder der Farm für den Wert der FarmName-Eigenschaft angeben.

Um eine Verbindung mit dem Namespace "CIMV2\TerminalServices" herzustellen, muss die Authentifizierungsebene den Paketschutz enthalten. Bei C/C++-Aufrufen handelt es sich um eine Authentifizierungsebene von RPC_C_AUTHN_LEVEL_PKT_PRIVACY, die mithilfe der COM-Funktion CoSetProxyBlanket festgelegt werden kann. Für Visual Basic- und Skriptaufrufe ist dies eine Authentifizierungsebene von WbemAuthenticationLevelPktPrivacy oder "pktPrivacy" mit dem Wert 6. Das folgende Visual Basic Scripting Edition (VBScript)-Beispiel zeigt, wie Sie eine Verbindung mit einem Remotecomputer mit Paketschutz herstellen.

strComputer = "RemoteServer1" 
Set objServices = GetObject( _
    "winmgmts:{authenticationLevel=pktPrivacy}!Root/CIMv2/TerminalServices")

MOF-Dateien (Managed Object Format) enthalten die Definitionen für WMI-Klassen (Windows Management Instrumentation). Sie werden auf dem Computer installiert, wenn Sie die zugeordnete Rolle hinzufügen. Weitere Informationen zu MOF-Dateien finden Sie unter Managed Object Format (MOF).

Anforderungen

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