Share via

Msvm_TerminalService-Klasse

  • Artikel

Verwaltet alle Remoteterminalverbindungen mit einem bestimmten Host. Der Dienst verwendet einen konfigurierbaren Port, um alle Terminalverbindungen zu initiieren.

Die folgende Syntax ist vereinfachter MOF-Code (Managed Object Format) und enthält alle geerbten Eigenschaften.

Syntax

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_TerminalService : CIM_Service
{
  string   InstanceID;
  string   Caption = "Hyper-V Terminal Service";
  string   Description = "Microsoft Virtual Terminal Service";
  string   ElementName = "Hyper-V Terminal Service";
  datetime InstallDate;
  uint16   OperationalStatus[] = { 2 };
  string   StatusDescriptions[] = { "The virtual terminal connection management service is fully operational" };
  string   Status = "OK";
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  string   EnabledState = 2;
  string   OtherEnabledState;
  uint16   RequestedState = 12;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   SystemCreationClassName = "Msvm_ComputerSystem";
  string   SystemName;
  string   Name = "termsvc";
  string   CreationClassName = "Msvm_TerminalService";
  string   PrimaryOwnerName;
  string   PrimaryOwnerContact;
  string   StartMode;
  boolean  Started;
};

Member

Die Msvm_TerminalService-Klasse verfügt über die folgenden Membertypen:

Methoden

Die Msvm_TerminalService-Klasse verfügt über diese Methoden.

Methode Beschreibung
GetInteractiveSessionACL Ruft die aktuelle DACL ab, die den Zugriff auf die interaktive Sitzung eines virtuellen Computers steuert.
GrantInteractiveSessionAccess Gewährt der angegebenen Liste der Trustees Zugriff auf die interaktive Sitzung des virtuellen Computers.
ModifyServiceSettings Ändert die Einstellungsdaten für den Dienst.
RequestStateChange Fordert eine Zustandsänderung an.
RevokeInteractiveSessionAccess Widerruft den Zugriff auf die interaktive Sitzung des virtuellen Computers aus der angegebenen Liste der Treuhänder.
Startservice Startet den Dienst.
StopService Beendet den Dienst.

Eigenschaften

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

AvailableRequestedStates

Datentyp: uint16-Array

Zugriffstyp: Schreibgeschützt

Gibt die möglichen Werte für den RequestedState-Parameter der RequestStateChange-Methode an. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt.

Caption

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Eine kurze Beschreibung des Objekts. Diese Eigenschaft wird von CIM_ManagedElement geerbt.

CommunicationStatus

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Gibt die Fähigkeit der Instrumentierung an, mit dem zugrunde liegenden verwalteten Element zu kommunizieren. Ein Null-Wert gibt an, dass diese Eigenschaft nicht implementiert ist. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Unbekannt (0)

Nicht verfügbar (1)

Kommunikation OK (2)

Kommunikation verloren (3)

Kein Kontakt (4)

DMTF Reserviert (..)

Vendor Reserved (0x8000.. )

CreationClassName

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Der Name der Klasse oder Unterklasse, die bei der Erstellung eines instance verwendet wird. Diese Eigenschaft wird von CIM_Service geerbt.

Beschreibung

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Eine Beschreibung des -Objekts. Diese Eigenschaft wird von CIM_ManagedElement geerbt.

DetailedStatus

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Ergänzt die PrimaryStatus-Eigenschaft mit zusätzlichen status Details. Ein Null-Wert gibt an, dass diese Eigenschaft nicht implementiert ist. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Nicht verfügbar (0)

Keine zusätzlichen Informationen (1)

Gestresst (2)

Vorhersagefehler (3)

Nicht wiederherstellbarer Fehler (4)

Unterstützen von Entitäten im Fehler (5)

DMTF Reserviert (..)

Vendor Reserved (0x8000.. )

ElementName

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Ein Anzeigename für das Objekt. Diese Eigenschaft wird von CIM_ManagedElement geerbt.

EnabledDefault

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Die Standard- oder Startkonfiguration eines Administrators für den aktivierten Status eines Elements. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt.

EnabledState

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Die aktivierten und deaktivierten Zustände eines Elements. Es kann auch die Übergänge zwischen diesen angeforderten Zuständen angeben. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt.

HealthState

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Die aktuelle Integrität des Elements. Dieses Attribut drückt die Integrität dieses Elements aus, aber nicht unbedingt die integrität seiner Unterkomponenten. Die möglichen Werte sind 0 bis 30, wobei 5 bedeutet, dass das Element vollständig fehlerfrei ist und 30 bedeutet, dass das Element vollständig nicht funktionsfähig ist. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

InstallDate

Datentyp: datetime

Zugriffstyp: Schreibgeschützt

Das Datum und die Uhrzeit der Erstellung der Konfiguration des virtuellen Computers. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

InstanceID

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: Schlüssel

Identifiziert eindeutig einen instance dieser Klasse. Diese Eigenschaft wird von CIM_ManagedElement geerbt und ist immer auf NULL festgelegt.

Name

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Die Bezeichnung, unter der das Objekt bekannt ist. Diese Eigenschaft wird von CIM_Service geerbt.

OperatingStatus

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Stellt aktuelle status Informationen für den Betriebszustand des Elements bereit und kann verwendet werden, um weitere Details in Bezug auf den Wert der EnabledState-Eigenschaft bereitzustellen. Ein Null-Wert gibt an, dass diese Eigenschaft nicht implementiert ist. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Unbekannt (0)

Nicht verfügbar (1)

Wartung (2)

Ab (3)

Beenden (4)

Beendet (5)

Abgebrochen (6)

Ruhend (7)

Abgeschlossen (8)

Migrieren (9)

Auswandern (10)

Immigrieren (11)

Momentaufnahme (12)

Herunterfahren (13)

Im Test (14)

Übergang (15)

Im Dienst (16)

DMTF Reserviert (..)

Vendor Reserved (0x8000.. )

OperationalStatus

Datentyp: uint16-Array

Zugriffstyp: Schreibgeschützt

Die aktuellen Status des Objekts. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

OtherEnabledState

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Eine Zeichenfolge, die den aktivierten oder deaktivierten Zustand des Elements beschreibt, wenn die EnabledState-Eigenschaft auf 1 (Sonstige) festgelegt ist. Diese Eigenschaft muss auf NULL festgelegt werden, wenn EnabledState ein anderer Wert als 1 ist. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt.

PrimaryOwnerContact

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Ein Wert, der Informationen darüber bereitstellt, wie der primäre Besitzer des Diensts erreicht werden kann (z. B. Telefonnummer, E-Mail-Adresse usw.). Diese Eigenschaft wird von CIM_Service geerbt.

PrimaryOwnerName

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Der Name des primären Besitzers für den Dienst, sofern einer definiert ist. Der primäre Besitzer ist der erste Supportkontakt für den Dienst. Diese Eigenschaft wird von CIM_Service geerbt.

PrimaryStatus

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Stellt allgemeine status Informationen bereit. Diese Eigenschaft sollte in Verbindung mit der DetailedStatus-Eigenschaft verwendet werden, um eine allgemeine und detaillierte Integrität status des Elements und seiner Unterkomponenten bereitzustellen. Ein Null-Wert gibt an, dass diese Eigenschaft nicht implementiert ist. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Unbekannt (0)

OK (1)

Beeinträchtigt (2)

Fehler (3)

DMTF Reserviert (..)

Vendor Reserved (0x8000.. )

RequestedState

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Der letzte angeforderte oder gewünschte Zustand für das Element. Der tatsächliche Zustand des Elements wird durch EnabledState dargestellt. Diese Eigenschaft wird bereitgestellt, um die zuletzt angeforderten und aktuellen aktivierten oder deaktivierten Zustände zu vergleichen. Ein bestimmter instance von CIM_EnabledLogicalElement unterstützt möglicherweise die RequestStateChange-Methode nicht. In diesem Fall wird der Wert 12 (Nicht zutreffend) verwendet. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt.

Started

Datentyp: Boolesch

Zugriffstyp: Schreibgeschützt

Gibt an, ob der Dienst derzeit ausgeführt wird. Diese Eigenschaft wird von CIM_Service geerbt.

StartMode

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Ein Zeichenfolgenwert, der angibt, ob der Dienst automatisch von einem System, einem Betriebssystem oder nur auf Anforderung gestartet wird. Diese Eigenschaft wird von CIM_Service geerbt.

Status

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Die status des Elements. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

StatusBeschreibungen

Datentyp: Zeichenfolgenarray

Zugriffstyp: Schreibgeschützt

Zeichenfolgen, die die verschiedenen OperationalStatus-Arraywerte beschreiben. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

SystemCreationClassName

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Der Name der Erstellungsklasse des Bereichssystems. Diese Eigenschaft wird von CIM_Service geerbt.

Systemname

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Der Name des Hostcomputersystems. Diese Eigenschaft wird von CIM_Service geerbt.

TimeOfLastStateChange

Datentyp: datetime

Zugriffstyp: Schreibgeschützt

Das Datum oder die Uhrzeit, zu dem sich der aktivierte Status des Elements zuletzt geändert hat. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt.

TransitioningToState

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Gibt den Zielzustand an, in den die instance übergehen. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt.

Bemerkungen

Der Zugriff auf die Msvm_TerminalService-Klasse kann durch die UAC-Filterung eingeschränkt werden. Weitere Informationen finden Sie unter Benutzerkontensteuerung und WMI.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
 Windows Server 2012 [nur Desktop-Apps]
Namespace
 Stamm\Virtualization\V2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

Siehe auch

CIM_Service