Condividi tramite

Classe Win32_SystemDriver

  • Articolo

La classe WMI Win32_SystemDriverrappresenta il driver di sistema per un servizio di base.

La sintassi seguente è semplificata dal codice MOF (Managed Object Format) e include tutte le proprietà ereditate. Le proprietà e i metodi sono in ordine alfabetico, non in ordine MOF.

Sintassi

[Dynamic, Provider("CIMWin32"), SupportsUpdate, UUID("{8502C4C5-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_SystemDriver : Win32_BaseService
{
  boolean  AcceptPause;
  boolean  AcceptStop;
  string   Caption;
  string   CreationClassName;
  string   Description;
  boolean  DesktopInteract;
  string   DisplayName;
  string   ErrorControl;
  uint32   ExitCode;
  datetime InstallDate;
  string   Name;
  string   PathName;
  uint32   ServiceSpecificExitCode;
  string   ServiceType;
  boolean  Started;
  string   StartMode;
  string   StartName;
  string   State;
  string   Status;
  string   SystemCreationClassName;
  string   SystemName;
  uint32   TagId;
};

Membri

La classe Win32_SystemDriver ha questi tipi di membri:

Metodi

La classe Win32_SystemDriver dispone di questi metodi.

Metodo Descrizione
Modifica Metodo di classe che modifica un servizio.
ChangeStartMode Metodo di classe che modifica la modalità di avvio di un servizio.
Crea Metodo di classe che crea un nuovo servizio.
CANC Metodo di classe che elimina un servizio esistente.
InterrogateService Metodo di classe che richiede che il servizio aggiorni lo stato a Service Manager.
PauseService Metodo di classe che tenta di posizionare il servizio nello stato sospeso.
ResumeService Metodo di classe che tenta di posizionare il servizio nello stato ripreso.
Startservice Metodo di classe che tenta di posizionare il servizio nello stato di avvio.
StopService Metodo di classe che inserisce il servizio nello stato arrestato.
UserControlService Metodo di classe che tenta di inviare un codice di controllo definito dall'utente a un servizio.

 

Proprietà

La classe Win32_SystemDriver ha queste proprietà.

AcceptPause

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API|Strutture dei servizi |edizione StandardRVICE_STATUS|dwControlsAccepted|edizione StandardRVICE_ACCEPT_PAUedizione Standard_CONTINUE"), DisplayName ("Service Accetta pausa")

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 dei servizi |edizione StandardRVICE_STATUS|dwControlsAccepted|edizione StandardRVICE_ACCEPT_STOP"), DisplayName ("Service Accetta arresto")

Il servizio può essere arrestato.

Questa proprietà viene ereditata da Win32_BaseService.

Caption

Tipo di dati: string

Tipo di accesso: sola lettura

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

Breve descrizione dell'oggetto.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

CreationClassName

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: CIM_Key, DisplayName ("Nome classe")

Nome della prima classe concreta da visualizzare nella catena di ereditarietà utilizzata nella creazione di un'istanza. Se utilizzata con le altre proprietà chiave della classe , questa proprietà consente di identificare in modo univoco tutte le istanze di questa classe e delle relative sottoclassi.

Questa proprietà viene ereditata da CIM_Service.

Descrizione

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: DisplayName ("Description")

Descrizione dell'oggetto.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

DesktopInteract

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API|Strutture dei servizi |QUERY_edizione StandardRVICE_CONFIG|dwServiceType|edizione StandardRVICE_INTERACTIVE_PROCESS"), DisplayName ("Interagisce con desktop")

Questo servizio può creare o comunicare con le finestre sul desktop.

Questa proprietà viene ereditata da Win32_BaseService.

DisplayName

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API|Strutture dei servizi |QUERY_edizione StandardRVICE_CONFIG|lpDisplayName"), DisplayName ("Nome visualizzato")

Nome visualizzato del servizio. La lunghezza massima della stringa è di 256 caratteri. Il nome viene mantenuto senza distinzione tra maiuscole e minuscole in Gestione controllo servizi. I confronti di DisplayName non fanno sempre distinzione tra maiuscole e minuscole.

Vincoli: accetta lo stesso valore della proprietà Name .

Esempio: "Atdisk"

Questa proprietà viene ereditata da Win32_BaseService.

ErrorControl

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API|Strutture dei servizi |QUERY_edizione StandardRVICE_CONFIG|dwErrorControl"), DisplayName ("Gravità dell'errore di avvio")

Gravità dell'errore se il servizio non viene avviato durante l'avvio. Questo valore indica l'azione eseguita dal programma di avvio in caso di errore. Tutti gli errori vengono registrati dal computer.

Questa proprietà viene ereditata da Win32_BaseService.

Ignora ("Ignora")

L'utente non viene notificato.

Normale ("Normale ")

L'utente viene notificato.

Grave ("Grave")

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

Critico ("Critico ")

Il sistema tenta un riavvio con una configurazione valida.

Sconosciuto ("Sconosciuto")

La causa dell'errore è sconosciuta.

ExitCode

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API|Strutture dei servizi |edizione StandardRVICE_STATUS|dwWin32ExitCode"), DisplayName ("Codice di uscita")

Codice di errore di Windows che definisce eventuali problemi riscontrati durante l'avvio o l'arresto del servizio. Questa proprietà viene impostata su ERROR_SERVICE_SPECIFIC_ERROR (1066) quando l'errore è univoco per il servizio rappresentato da questa classe. Le informazioni relative all'errore sono disponibili nella proprietà ServiceSpecificExitCode . Il servizio imposta questo valore su NO_ERROR durante l'esecuzione e di nuovo alla chiusura normale.

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 è stato installato. Questa proprietà non richiede un valore per indicare che l'oggetto è installato.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Nome

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: Chiave

Identificatore univoco per il servizio che fornisce un'indicazione della funzionalità gestita. Questa funzionalità è descritta in modo più dettagliato nella proprietà Description dell'oggetto.

Questa proprietà viene ereditata da CIM_Service.

PathName

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API|Strutture dei servizi |QUERY_edizione StandardRVICE_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.

ServiceSpecificExitCode

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API|Strutture dei servizi |edizione StandardRVICE_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_edizione StandardRVICE_SPECIFIC_ERROR (1066).

Questa proprietà viene ereditata da Win32_BaseService.

Servicetype

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API|Strutture dei servizi |QUERY_edizione StandardRVICE_CONFIG|dwServiceType"), DisplayName ("Tipo di servizio")

Tipo di servizio fornito ai processi chiamanti.

Questa proprietà viene ereditata da Win32_BaseService.

I valori sono:

Driver kernel ("driver kernel")

Driver file system ("driver file system")

Adapter ("Adapter ")

Driver Recognizer ("Recognizer Driver")

Processo personale ("Processo personale")

Processo di condivisione ("processo di condivisione")

Processo interattivo ("processo interattivo")

Introduzione

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: DisplayName ("Started")

Il servizio è stato avviato.

Questa proprietà viene ereditata da CIM_Service.

StartMode

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: DisplayName ("modalità start")

Modalità di avvio del driver di sistema.

Questa proprietà viene ereditata da Win32_BaseService.

Avvio ("Avvio ")

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

Sistema ("Sistema")

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

Auto ("Auto ")

Servizio da avviare automaticamente dal gestore di controllo del servizio durante l'avvio del sistema.

Manuale ("Manuale")

Servizio da avviare dal gestore di controllo del servizio quando un processo chiama il metodo StartService.

Disabilitato ("Disabilitato ")

Servizio che non può più essere avviato.

StartName

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API|Strutture dei servizi |QUERY_edizione StandardRVICE_CONFIG|lpServiceStartName"), DisplayName ("Nome account iniziale")

Nome dell'account con cui viene eseguito il servizio. A seconda del tipo di servizio, il nome dell'account può essere sotto forma di NomeDominio\NomeUtente. Il processo del servizio verrà registrato usando uno di questi due moduli durante l'esecuzione. Se l'account appartiene al dominio predefinito, è possibile specificare .\Username. Se si specifica NULL , il servizio verrà connesso come account LocalSystem. 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 input e output (I/O) per caricare il driver di dispositivo. Inoltre, se si specifica 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.

Stato

Tipo di dati: string

Tipo di accesso: lettura/scrittura

Qualificatori: MappingStrings ("Win32API|Strutture dei servizi |edizione StandardRVICE_STATUS|dwCurrentState "), DisplayName ("State")

Stato corrente del servizio di base.

Questa proprietà viene ereditata da Win32_BaseService.

I valori sono:

Arrestato ("Arrestato")

Inizio in sospeso ("Inizio in sospeso ")

Stop Pending ("Stop Pending ")

Esecuzione ("in esecuzione ")

Continua in sospeso ("Continua in sospeso")

Sospendi in sospeso ("Sospendi in sospeso")

Sospeso ("sospeso ")

Sconosciuto ("Sconosciuto")

Stato

Tipo di dati: string

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'unità disco rigido abilitata per SMART, potrebbe funzionare correttamente, ma prevedere un errore nel prossimo futuro). Gli stati non operativi includono: "Error", "Starting", "Stopping" e "Service". Quest'ultimo, "Servizio", può essere applicato durante il ridimensionamento mirror di un disco, il ricaricamento di un elenco di autorizzazioni utente o altre operazioni amministrative. Non tutte queste operazioni sono online, ma l'elemento gestito non è "OK" né in uno degli altri stati.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

I valori sono:

OK ("OK ")

Errore ("Errore ")

Degradato ("degradato")

Sconosciuto ("Sconosciuto")

Pred Fail ("Pred Fail ")

Avvio ("Starting ")

Arresto ("arresto ")

Servizio ("Servizio")

Sottolineato ("sottolineato ")

NonRecover ("NonRecover ")

Nessun contatto ("Nessun contatto ")

Lost Comm ("Lost Comm ")

SystemCreationClassName

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: propagati ("CIM_System.CreationClassName"), CIM_Key, DisplayName ("System Class Name")

Digitare il nome del sistema che ospita il servizio.

Questa proprietà viene ereditata da CIM_Service.

Systemname

Tipo di dati: string

Tipo di accesso: sola lettura

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

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 dei servizi |QUERY_edizione StandardRVICE_CONFIG|dwTagId"), DisplayName ("Id tag")

Valore di tag univoco per questo servizio nel gruppo. Il valore 0 (zero) indica che al servizio non è stato assegnato un tag. È possibile usare un tag per l'avvio del servizio di ordinamento all'interno di un gruppo di ordini di carico specificando un vettore di ordine tag nel Registro di sistema all'indirizzo:

Questa proprietà viene ereditata da Win32_BaseService.

HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\GroupOrderList.

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

Osservazioni:

La classe Win32_SystemDriver deriva da Win32_BaseService.

Esempi

L'esempio di PowerShell seguente recupera una serie di proprietà dai driver di sistema in esecuzione in un computer.

Get-WmiObject -Class Win32_SystemDriver | Where-Object -FilterScript {$_.State -eq "Running"} | Where-Object -FilterScript {$_.StartMode -eq "Manual"} | Format-Table -Property Name,DisplayName

Requisiti

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

Vedi anche

Win32_BaseService

Classi del sistema operativo