Condividi tramite

classe Msvm_TerminalService

  • Articolo

Gestisce tutte le connessioni del terminale remoto a un determinato host. Il servizio usa una porta configurabile per avviare tutte le connessioni del terminale.

La sintassi seguente è il codice MOF (Managed Object Format) semplificato e include tutte le proprietà ereditate.

Sintassi

[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;
};

Members

La classe Msvm_TerminalService include questi tipi di membri:

Metodi

La classe Msvm_TerminalService include questi metodi.

Metodo Descrizione
GetInteractiveSessionACL Recupera l'elenco dati corrente che controlla l'accesso alla sessione interattiva di una macchina virtuale.
GrantInteractiveSessionAccess Concede l'accesso alla sessione interattiva della macchina virtuale all'elenco specificato di trustees.
ModifyServiceSettings Modifica i dati di impostazione per il servizio.
RequestStateChange Richiede una modifica dello stato.
RevInteractiveSessionAccess Revoca l'accesso alla sessione interattiva della macchina virtuale dall'elenco specificato di trustees.
Startservice avvia il servizio.
StopService arresta il servizio.

Proprietà

La classe Msvm_TerminalService ha queste proprietà.

AvailableRequestedStates

Tipo di dati: matrice uint16

Tipo di accesso: sola lettura

Indica i valori possibili per il parametro RequestedState del metodo RequestStateChange . Questa proprietà viene ereditata da CIM_EnabledLogicalElement.

Didascalia

Tipo di dati: stringa

Tipo di accesso: sola lettura

Breve descrizione dell'oggetto. Questa proprietà viene ereditata da CIM_ManagedElement.

CommunicationStatus

Tipo di dati: uint16

Tipo di accesso: sola lettura

Indica la capacità della strumentazione di comunicare con l'elemento gestito sottostante. Un valore Null indica che questa proprietà non è implementata. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Sconosciuto (0)

Non disponibile (1)

Comunicazione OK (2)

Comunicazione persa (3)

Nessun contatto (4)

DMTF Riservato (..)

Fornitore riservato (0x8000.).

CreationClassName

Tipo di dati: stringa

Tipo di accesso: sola lettura

Nome della classe o della sottoclasse utilizzata nella creazione di un'istanza. Questa proprietà viene ereditata da CIM_Service.

Descrizione

Tipo di dati: stringa

Tipo di accesso: sola lettura

Descrizione dell'oggetto . Questa proprietà viene ereditata da CIM_ManagedElement.

DetailedStatus

Tipo di dati: uint16

Tipo di accesso: sola lettura

Complimenta la proprietà PrimaryStatus con dettagli di stato aggiuntivi. Un valore Null indica che questa proprietà non è implementata. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Non disponibile (0)

Nessuna informazione aggiuntiva (1)

Stressato (2)

Errore predittivo (3)

Errore non recuperabile (4)

Entità di supporto nell'errore (5)

DMTF Riservato (..)

Fornitore riservato (0x8000.).

ElementName

Tipo di dati: stringa

Tipo di accesso: sola lettura

Nome visualizzato per l'oggetto. Questa proprietà viene ereditata da CIM_ManagedElement.

EnabledDefault

Tipo di dati: uint16

Tipo di accesso: sola lettura

Configurazione predefinita o di avvio di un amministratore per lo stato abilitato di un elemento. Questa proprietà viene ereditata da CIM_EnabledLogicalElement.

EnabledState

Tipo di dati: stringa

Tipo di accesso: sola lettura

Stati abilitati e disabilitati di un elemento. Può anche indicare le transizioni tra questi stati richiesti. Questa proprietà viene ereditata da CIM_EnabledLogicalElement.

HealthState

Tipo di dati: uint16

Tipo di accesso: sola lettura

Integrità corrente dell'elemento. Questo attributo esprime l'integrità di questo elemento, ma non necessariamente quella dei relativi sottocomponenti. I valori possibili sono da 0 a 30, dove 5 significa che l'elemento è completamente integro e 30 significa che l'elemento è completamente non funzionante. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

InstallDate

Tipo di dati: datetime

Tipo di accesso: sola lettura

Data e ora di creazione della configurazione della macchina virtuale. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

InstanceID

Tipo di dati: stringa

Tipo di accesso: sola lettura

Qualificatori: Chiave

Identifica in modo univoco un'istanza di questa classe. Questa proprietà viene ereditata da CIM_ManagedElement e viene sempre impostata su Null.

Nome

Tipo di dati: stringa

Tipo di accesso: sola lettura

Etichetta in base alla quale l'oggetto è noto. Questa proprietà viene ereditata da CIM_Service.

OperatingStatus

Tipo di dati: uint16

Tipo di accesso: sola lettura

Fornisce informazioni sullo stato correnti per la condizione operativa dell'elemento e può essere usato per fornire maggiori dettagli rispetto al valore della proprietà EnabledState . Un valore Null indica che questa proprietà non è implementata. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Sconosciuto (0)

Non disponibile (1)

Manutenzione (2)

Avvio (3)

Arresto (4)

Arrestato (5)

Interrotto (6)

Inattivo (7)

Completato (8)

Migrazione (9)

Emigrazione (10)

Immigrazione (11)

Snapshotting (12)

Arresto (13)

In Test (14)

Transizione (15)

Nel servizio (16)

DMTF Riservato (..)

Fornitore riservato (0x8000.).

OperationalStatus

Tipo di dati: matrice uint16

Tipo di accesso: sola lettura

Stato corrente dell'oggetto. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

OtherEnabledState

Tipo di dati: stringa

Tipo di accesso: sola lettura

Stringa che descrive lo stato abilitato o disabilitato dell'elemento quando la proprietà EnabledState è impostata su 1 (Altro). Questa proprietà deve essere impostata su Null quando EnabledState è qualsiasi valore diverso da 1. Questa proprietà viene ereditata da CIM_EnabledLogicalElement.

PrimaryOwnerContact

Tipo di dati: stringa

Tipo di accesso: sola lettura

Valore che fornisce informazioni sul modo in cui è possibile raggiungere il proprietario primario del servizio, ad esempio il numero di telefono, l'indirizzo di posta elettronica e così via. Questa proprietà viene ereditata da CIM_Service.

PrimaryOwnerName

Tipo di dati: stringa

Tipo di accesso: sola lettura

Nome del proprietario primario per il servizio, se ne viene definito uno. Il proprietario primario è il contatto di supporto iniziale per il servizio. Questa proprietà viene ereditata da CIM_Service.

PrimaryStatus

Tipo di dati: uint16

Tipo di accesso: sola lettura

Fornisce informazioni di stato di alto livello. Questa proprietà deve essere usata insieme alla proprietà DetailedStatus per fornire stato di integrità elevato e dettagliato dell'elemento e dei relativi sottocomponenti. Un valore Null indica che questa proprietà non è implementata. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Sconosciuto (0)

OK (1)

Degradato (2)

Errore (3)

DMTF Riservato (..)

Fornitore riservato (0x8000.).

RequestedState

Tipo di dati: uint16

Tipo di accesso: sola lettura

Ultimo stato richiesto o desiderato per l'elemento. Lo stato effettivo dell'elemento è rappresentato da EnabledState. Questa proprietà viene fornita per confrontare gli ultimi stati richiesti e correnti abilitati o disabilitati. Un'istanza specifica di CIM_EnabledLogicalElement potrebbe non supportare il metodo RequestStateChange . In questo caso, viene usato il valore 12 (non applicabile). Questa proprietà viene ereditata da CIM_EnabledLogicalElement.

Avviato

Tipo di dati: booleano

Tipo di accesso: sola lettura

Indica se il servizio è attualmente in esecuzione. Questa proprietà viene ereditata da CIM_Service.

Modalità avvio

Tipo di dati: stringa

Tipo di accesso: sola lettura

Valore stringa che indica se il servizio viene avviato automaticamente da un sistema, un sistema operativo o viene avviato solo dopo la richiesta. Questa proprietà viene ereditata da CIM_Service.

Status

Tipo di dati: stringa

Tipo di accesso: sola lettura

Stato dell'elemento. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

StatusDescriptions

Tipo di dati: matrice di stringhe

Tipo di accesso: sola lettura

Stringhe che descrivono i vari valori della matrice OperationalStatus . Questa proprietà viene ereditata da CIM_ManagedSystemElement.

SystemCreationClassName

Tipo di dati: string

Tipo di accesso: sola lettura

Nome della classe di creazione del sistema di ambito. Questa proprietà viene ereditata da CIM_Service.

Systemname

Tipo di dati: string

Tipo di accesso: sola lettura

Nome del sistema del computer di hosting. Questa proprietà viene ereditata da CIM_Service.

TimeOfLastStateChange

Tipo di dati: datetime

Tipo di accesso: sola lettura

Data o ora dell'ultima modifica dello stato abilitato dell'elemento. Questa proprietà viene ereditata da CIM_EnabledLogicalElement.

TransitioningToState

Tipo di dati: uint16

Tipo di accesso: sola lettura

Indica lo stato di destinazione in cui viene eseguita la transizione dell'istanza. Questa proprietà viene ereditata da CIM_EnabledLogicalElement.

Commenti

L'accesso alla classe Msvm_TerminalService potrebbe essere limitato dal filtro controllo dell'account utente. Per altre informazioni, vedere Controllo dell'account utente e WMI.

Requisiti

Requisito Valore
Client minimo supportato
 Windows 8 [solo app desktop]
Server minimo supportato
 Windows Server 2012 [solo app desktop]
Spazio dei nomi
 Root\Virtualization\V2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

Vedi anche

CIM_Service