Classe Win32_TerminalService

  • Articolo

La classe WMI Win32_TerminalService è una sottoclasse della classe Win32_Service . Win32_TerminalService rappresenta la proprietà Element dell'associazione Win32_TerminalServiceToSetting .

La sintassi seguente è semplificata dal codice MOF e include tutte le proprietà definite e ereditate, in ordine alfabetico.

Sintassi

[dynamic, provider("Win32_WIN32_TERMINALSERVICE_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer"), AMENDMENT]
class Win32_TerminalService : Win32_Service
{
  boolean  AcceptPause;
  boolean  AcceptStop;
  string   Caption;
  uint32   CheckPoint;
  string   CreationClassName;
  boolean  DelayedAutoStart;
  string   Description;
  boolean  DesktopInteract;
  string   DisplayName;
  string   ErrorControl;
  uint32   ExitCode;
  datetime InstallDate;
  string   Name;
  string   PathName;
  uint32   ProcessId;
  uint32   ServiceSpecificExitCode;
  string   ServiceType;
  boolean  Started;
  string   StartMode;
  string   StartName;
  string   State;
  string   Status;
  string   SystemCreationClassName;
  string   SystemName;
  uint32   TagId;
  uint32   WaitHint;
  uint32   DisconnectedSessions;
  uint32   TotalSessions;
};

Members

La classe Win32_TerminalService include questi tipi di membri:

Metodi

La classe Win32_TerminalService include questi metodi.

Metodo Descrizione
Cambiare Modifica un servizio.
ChangeStartMode Modifica la modalità di avvio di un servizio.
Crea Crea un nuovo servizio.
Elimina Elimina un servizio esistente.
GetSecurityDescriptor Restituisce il descrittore di sicurezza che controlla l'accesso al servizio.
InterrogateService Richiede che un servizio aggiorni lo stato al service manager.
PauseService Tenta di inserire un servizio nello stato sospeso.
ResumeService Tenta di inserire un servizio nello stato ripreso.
SetSecurityDescriptor Scrive una versione aggiornata del descrittore di sicurezza che controlla l'accesso al servizio.
Startservice Tenta di inserire un servizio nello stato di avvio.
StopService Inserisce un servizio nello stato arrestato.
UserControlService Tenta di inviare un codice di controllo definito dall'utente a un servizio.

Proprietà

La classe Win32_TerminalService ha queste proprietà.

AcceptPause

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Strutture di servizio | SERVICE_STATUS|dwControlsAccepted| SERVICE_ACCEPT_PAUSE_CONTINUE"), DisplayName ("Service Accetta pausa")

Indica se il servizio può essere sospeso.

Questa proprietà viene ereditata da Win32_BaseService.

AcceptStop

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Strutture di servizio | SERVICE_STATUS|dwControlsAccepted| SERVICE_ACCEPT_STOP"), DisplayName ("Service Accetta stop")

Indica se il servizio può essere arrestato.

Questa proprietà viene ereditata da Win32_BaseService.

Didascalia

Tipo di dati: stringa

Tipo di accesso: sola lettura

Qualificatori: MaxLen (64), DisplayName ("Didascalia")

Breve descrizione del servizio di una stringa a una riga.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Checkpoint

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Strutture di servizio | SERVICE_STATUS|dwCheckPoint"), DisplayName ("Check Point Count")

Valore che il servizio incrementa periodicamente per segnalare lo stato di avanzamento durante un'operazione di avvio, arresto, sospensione o continuazione. Ad esempio, il servizio incrementa questo valore man mano che completa ogni passaggio della relativa inizializzazione all'avvio. Il programma dell'interfaccia utente che richiama l'operazione nel servizio usa questo valore per tenere traccia dello stato di avanzamento del servizio durante un'operazione prolungata. Questo valore non è valido e deve essere zero quando il servizio non ha un avvio, un'interruzione, una pausa o continuare l'operazione in sospeso.

Questa proprietà viene ereditata da Win32_Service.

CreationClassName

Tipo di dati: stringa

Tipo di accesso: sola lettura

Qualificatori: CIM_Key, DisplayName ("Nome classe")

Nome della prima classe concreta da visualizzare nella catena di ereditarietà usata nella creazione di un'istanza. Se usato con le altre proprietà chiave della classe, questa proprietà consente a tutte le istanze di questa classe e alle relative sottoclassi di essere identificate in modo univoco.

Questa proprietà viene ereditata da CIM_Service.

DelayedAutoStart

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Strutture di servizio | SERVICE_DELAYED_AUTO_START_INFO|fDelayedAutostart"), DisplayName ("Avvio automatico ritardato")

Se True, il servizio viene avviato dopo l'avvio automatico di altri servizi e un breve ritardo.

Windows Server 2012 R2, Windows 8.1, Windows Server 2012, Windows 8, Windows Server 2008 R2, Windows 7, Windows Server 2008 e Windows Vista: questa proprietà non è supportata prima di Windows Server 2016 e Windows 10 .

Questa proprietà viene ereditata da Win32_Service.

Descrizione

Tipo di dati: stringa

Tipo di accesso: sola lettura

Qualificatori: DisplayName ("Descrizione")

Descrizione dell'oggetto.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

DesktopInteract

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Strutture di servizio | QUERY_SERVICE_CONFIG|dwServiceType| SERVICE_INTERACTIVE_PROCESS"), DisplayName ("Interagisce con Desktop")

Indica se il servizio può creare o comunicare con finestre sul desktop e quindi interagire in qualche modo con un utente. I servizi interattivi devono essere eseguiti nell'account di sistema locale. La maggior parte dei servizi non è interattiva; ovvero, non comunicano con l'utente in alcun modo.

Questa proprietà viene ereditata da Win32_BaseService.

Sessioni disconnesse

Tipo di dati: uint32

Tipo di accesso: sola lettura

Numero di sessioni disconnesse nel server corrente. Queste sessioni possono comunque usare attivamente le risorse del server, tuttavia attualmente non hanno alcuna connessione di rete con un client.

DisplayName

Tipo di dati: stringa

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Strutture di servizio | QUERY_SERVICE_CONFIG|lpDisplayName"), DisplayName ("Nome visualizzato")

Nome del servizio come visualizzato nello snap-in Servizi. La lunghezza massima della stringa è di 256 caratteri. Si noti che il nome visualizzato e il nome del servizio (archiviato nel Registro di sistema) non sono sempre uguali. Ad esempio, il servizio client DHCP ha il nome del servizio Dhcp, ma il nome visualizzato client DHCP. Il nome viene mantenuto in caso di maiuscole e minuscole in Service Control Manager. Tuttavia, i confronti di DisplayName sono sempre senza distinzione tra maiuscole e minuscole.

Vincolo: accetta lo stesso valore della proprietà Name .

Esempio: "Atdisk"

Questa proprietà viene ereditata da Win32_BaseService.

ErrorControl

Tipo di dati: stringa

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Strutture di servizio | QUERY_SERVICE_CONFIG|dwErrorControl"), DisplayName ("Gravità dell'errore di avvio")

Gravità dell'errore se questo servizio non viene avviato durante l'avvio. Il valore indica l'azione eseguita dal programma di avvio se si verifica un errore. Tutti gli errori vengono registrati dal computer.

Ignora ("Ignora ")

L'utente non viene notificato.

Normale ("Normale ")

L'utente viene notificato. In genere questa sarà una finestra di messaggio che invia una notifica all'utente del problema.

Grave ("Grave ")

Il sistema viene riavviato con l'ultima configurazione valida nota.

Critico ("Critico ")

Il sistema tenta un riavvio con una configurazione valida. Se il servizio non riesce a avviare una seconda volta, l'avvio ha esito negativo.

Sconosciuto ("sconosciuto ")

La gravità dell'errore è sconosciuta.

Questa proprietà viene ereditata da Win32_BaseService.

ExitCode

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Strutture di servizio | SERVICE_STATUS|dwWin32ExitCode"), DisplayName ("Exit Code")

Codice di errore di Windows che definisce gli errori riscontrati nell'avvio o nell'arresto del servizio. Questa proprietà è impostata su ERROR_SERVICE_SPECIFIC_ERROR (1066) quando l'errore è univoco per il servizio rappresentato da questa classe e le informazioni sull'errore sono disponibili nella proprietà ServiceSpecificExitCode . Il servizio imposta questo valore su NO_ERROR durante l'esecuzione e nuovamente al termine della normale terminazione.

Questa proprietà viene ereditata da Win32_BaseService.

InstallDate

Tipo di dati: datetime

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("MIF). DMTF| ComponentID|001.5"), DisplayName ("Data di installazione")

L'oggetto Date è installato. Questa proprietà non richiede un valore per indicare che l'oggetto è installato.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Nome

Tipo di dati: stringa

Tipo di accesso: sola lettura

Qualificatori: Chiave

Identificatore univoco del servizio che fornisce un'indicazione della funzionalità gestita. Questa funzionalità è descritta nella proprietà Description dell'oggetto .

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

PathName

Tipo di dati: stringa

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Strutture di servizio | QUERY_SERVICE_CONFIG|lpBinaryPathName"), DisplayName ("Nome percorso file")

Percorso completo del file binario del servizio che implementa il servizio.

Esempio: "\SystemRoot\System32\drivers\afd.sys"

Questa proprietà viene ereditata da Win32_BaseService.

Processid

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Strutture di servizio | SERVICE_STATUS_PROCESS|dwProcessId"), DisplayName ("Id processo")

Identificatore del processo del servizio.

Esempio: 324

Questa proprietà viene ereditata da Win32_Service.

ServiceSpecificExitCode

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Strutture di servizio | SERVICE_STATUS|dwServiceSpecificExitCode"), DisplayName ("Codice di uscita specifico del server")

Codice di errore specifico del servizio per gli errori che si verificano durante l'avvio o l'arresto del servizio. I codici di uscita sono definiti dal servizio rappresentato da questa classe. Questo valore viene impostato solo quando il valore della proprietà ExitCode è ERROR_SERVICE_SPECIFIC_ERROR (1066).

Questa proprietà viene ereditata da Win32_BaseService.

ServiceType

Tipo di dati: stringa

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Strutture di servizio | QUERY_SERVICE_CONFIG|dwServiceType"), DisplayName ("Tipo di servizio")

Tipo di servizio fornito ai processi chiamanti.

I valori possibili sono:

Driver del kernel ("Driver kernel")

Driver file system ("driver file system")

Adapter ("Adapter ")

Driver di riconoscimento ("Riconoscimento driver ")

Processo personalizzato ("processo proprio")

Processo di condivisione ("Processo di condivisione")

Processo interattivo ("Processo interattivo")

Questa proprietà viene ereditata da Win32_BaseService.

Avviato

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: DisplayName ("Avviato")

Indica se il servizio viene avviato o meno.

Questa proprietà viene ereditata da CIM_Service.

Modalità avvio

Tipo di dati: stringa

Tipo di accesso: sola lettura

Qualificatori: DisplayName ("modalità start")

Modalità di avvio del servizio di base di Windows.

Avvio ("avvio ")

Driver di dispositivo avviato dal caricatore del sistema operativo (valido solo per i servizi driver).

Sistema ("Sistema ")

Driver del dispositivo avviato dal processo di inizializzazione del sistema operativo. Questo valore è valido solo per i servizi del driver.

Auto ("Auto ")

Servizio da avviare automaticamente da Gestione controllo servizi durante l'avvio del sistema. I servizi automatici vengono avviati anche se un utente non accede.

Manuale ("Manuale")

Servizio da avviare da Service Control Manager quando un processo chiama il metodo StartService . Questi servizi non iniziano a meno che un utente non accinga e li avvia.

Disabilitato ("Disabilitato ")

Servizio che non può essere avviato fino a quando startMode non viene modificato in Auto o Manuale.

Questa proprietà viene ereditata da CIM_Service.

StartName

Tipo di dati: stringa

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Strutture di servizio | QUERY_SERVICE_CONFIG|lpServiceStartName"), DisplayName ("Nome account iniziale")

Nome dell'account in cui viene eseguito un servizio. A seconda del tipo di servizio, il nome dell'account può essere nel formato "DomainName\Username" o UPN ("Username@DomainName"). Il processo di servizio viene registrato usando uno di questi due moduli quando viene eseguito. Se l'account appartiene al dominio predefinito, è possibile specificare ".\Username". Per i driver a livello di kernel o di sistema, StartName contiene il nome dell'oggetto driver, ovvero "\FileSystem\Rdr" o "\Driver\Xns") usato dal sistema di I/O per caricare il driver di dispositivo. Inoltre, se viene specificato NULL , il driver viene eseguito con un nome di oggetto predefinito creato dal sistema di I/O in base al nome del servizio.

Esempio: "DWDOM\Amministrazione"

Questa proprietà viene ereditata da Win32_BaseService.

State

Tipo di dati: stringa

Tipo di accesso: Lettura/scrittura

Qualificatori: MappingStrings ("Win32API| Strutture di servizio | SERVICE_STATUS|dwCurrentState "), DisplayName ("Stato")

Stato corrente del servizio di base.

I valori possibili sono:

Arrestato ("Arrestato ")

Avvia in sospeso ("Avvia in sospeso ")

Arresta in sospeso ("Arresta in sospeso ")

Esecuzione ("in esecuzione ")

Continuare in sospeso ("Continua in sospeso ")

Sospendere l'sospeso ("Sospendere in sospeso ")

Sospeso ("Sospeso ")

Sconosciuto ("sconosciuto ")

Windows Server 2008 e Windows Vista: Questa proprietà è di sola lettura prima di Windows 7 e Windows Server 2008 R2.

Questa proprietà viene ereditata da Win32_BaseService.

Status

Tipo di dati: stringa

Tipo di accesso: sola lettura

Qualificatori: MaxLen (10), DisplayName ("Status")

Stato corrente dell'oggetto. È possibile definire vari stati operativi e non operativi. Gli stati operativi includono: "OK", "Degraded" e "Pred Fail" (un elemento, ad esempio un disco rigido abilitato per SMART, può funzionare correttamente, ma stimare un errore nel prossimo futuro). Gli stati non operativi includono: "Error", "Starting", "Arresta" e "Servizio". Quest'ultimo, "Servizio", può essere applicato durante il ridimensionamento mirror di un disco, il ricaricamento di un elenco di autorizzazioni utente o altri lavori amministrativi. Non tutti questi lavori sono online, ma l'elemento gestito non è "OK" né in uno degli altri stati.

I valori possibili sono:

OK ("OK ")

Errore ("Errore")

Degradato ("degradato ")

Sconosciuto ("sconosciuto ")

Pred Fail ("Pred Fail ")

Avvio ("Avvio ")

Arresto ("Arresto")

Servizio ("Servizio ")

Sottolineato ("stressato ")

NonRecover ("NonRecover ")

Nessun contatto ("Nessun contatto ")

Lost Comm ("Lost Comm ")

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

SystemCreationClassName

Tipo di dati: stringa

Tipo di accesso: sola lettura

Qualificatori: propagati ("CIM_System. CreationClassName"), CIM_Key, DisplayName ("Nome classe di sistema")

Nome del sistema che ospita questo servizio.

Questa proprietà viene ereditata da CIM_Service.

Systemname

Tipo di dati: stringa

Tipo di accesso: sola lettura

Qualificatori: propagati ("CIM_System. Name"), CIM_Key, DisplayName ("Nome sistema")

Nome del sistema che ospita questo servizio.

Questa proprietà viene ereditata da CIM_Service.

TagId

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Strutture di servizio | QUERY_SERVICE_CONFIG|dwTagId"), DisplayName ("Id tag")

Valore univoco del tag per questo servizio nel gruppo. Un valore pari a 0 (zero) indica che il servizio non ha un tag. Un tag può essere usato per ordinare l'avvio del servizio all'interno di un gruppo di ordini di carico specificando un vettore di ordine tag nel Registro di sistema in cui si trova:

HKEY_LOCAL_MACHINE\Sistema\Currentcontrolset\Controllo\ GroupOrderList

I tag vengono valutati solo per i servizi di avvio driver kernel e driver file system con modalità di avvio o avvio del sistema.

Questa proprietà viene ereditata da Win32_BaseService.

TotalSessions

Tipo di dati: uint32

Tipo di accesso: sola lettura

Numero totale di sessioni nel server corrente. Include sessioni connesse e disconnesse.

WaitHint

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Strutture di servizio | SERVICE_STATUS|dwWaitHint"), DisplayName ("Tempo di attesa stimato")

Tempo stimato richiesto, in millisecondi, per un'operazione di avvio, arresto, sospensione o continuazione in sospeso. Dopo aver trascorso il tempo specificato, il servizio effettua la chiamata successiva al metodo SetServiceStatus con un valore CheckPoint incrementato o una modifica in CurrentState. Se la quantità di tempo specificata da WaitHint passa e CheckPoint non è stata incrementata o CurrentState non è stata modificata, la gestione del servizio o il programma di controllo del servizio presuppone che si sia verificato un errore.

Questa proprietà viene ereditata da Win32_Service.

Commenti

Poiché la classe Win32_TerminalService è una sottoclasse della classe Win32_Service , la classe eredita tutte le proprietà e i metodi di Win32_Service.

Win32_TerminalServiceSetting è associato a Win32_TerminalService come proprietà Setting dell'associazione Win32_TerminalServiceToSetting .

Win32_TSSessionDirectory è associato a Win32_TerminalService come proprietà Setting dell'associazione Win32_TSSessionDirectorySetting .

I file MOF (Managed Object Format) contengono le definizioni per le classi WMI (Management Instrumentation) di Windows. I file MOF non vengono installati come parte di Microsoft Windows Software Development Kit (SDK). Vengono installati nel server quando si aggiunge il ruolo associato usando il Server Manager. Per altre informazioni sui file MOF, vedere Managed Object Format (MOF).

Requisiti

Requisito Valore
Client minimo supportato
 Windows Vista
Server minimo supportato
 Windows Server 2008
Spazio dei nomi
 Root\CIMv2
MOF
TSCfgWmi.mof
DLL
TSCfgWmi.dll

Vedi anche

Win32_Service

Win32_TerminalServiceToSetting

Win32_TSSessionDirectory

Win32_BaseService

CIM_Service