_Classe ambiente Win32

La classe WMI _ dell'ambiente Win32 rappresenta un ambiente o un'impostazione dell'ambiente di sistema in un computer Windows. L'esecuzione di query su questa classe restituisce le variabili di ambiente disponibili in:

HKEY _ Ambiente _ del \ sistema di \ \ controllo CurrentControlSet \ \ del sistema del computer locale sessionmanager

e

HKEY _ \ Ambiente < utente > utenti \

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

Sintassi

[Dynamic, Provider("CIMWin32"), Privileges("SeRestorePrivilege"), UUID("{8502C4D2-5FBB-11D2-AAC1-006008C78BC7}"), SupportsCreate, CreateBy("PutInstance"), SupportsDelete, DeleteBy("DeleteInstance"), SupportsUpdate, AMENDMENT]
class Win32_Environment : CIM_SystemResource
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Status;
  string   Name;
  boolean  SystemVariable;
  string   UserName;
  string   VariableValue;
};

Members

La classe di _ ambiente Win32 presenta questi tipi di membri:

Proprietà

La classe dell' _ ambiente Win32 dispone di queste proprietà.

Didascalia

Tipo di dati: String

Tipo di accesso: sola lettura

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

Breve descrizione testuale dell'oggetto.

Questa proprietà viene ereditata da CIM _ ManagedSystemElement.

Descrizione

Tipo di dati: String

Tipo di accesso: sola lettura

Qualificatori: DisplayName ("Description")

Descrizione testuale dell'oggetto.

Questa proprietà viene ereditata da CIM _ ManagedSystemElement.

InstallDate

Tipo di dati: DateTime

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("MIF. DMTF | ComponentID | 001,5 "), DisplayName (" data di installazione ")

Indica quando l'oggetto è stato installato. La mancanza di un valore non indica che l'oggetto non è installato.

Questa proprietà viene ereditata da CIM _ ManagedSystemElement.

Nome

Tipo di dati: String

Tipo di accesso: lettura/scrittura

Qualificatori: override ("Name"), Key, MappingStrings ("Win32Registry | System \ \ CurrentControlSet \ \ Control \ \ Session Manager \ \ Environment")

Stringa di caratteri che specifica il nome di una variabile di ambiente basata su Windows. Specificando il nome di una variabile che non esiste ancora, un'applicazione crea una nuova variabile di ambiente.

Esempio: "Path"

Status

Tipo di dati: String

Tipo di accesso: sola lettura

Qualificatori: maxlen (10), DisplayName ("status")

Stringa che indica lo stato corrente dell'oggetto. È possibile definire lo stato operativo e non operativo. Lo stato operativo può includere "OK", "danneggiato" e "errore predazione". "Predator fail" indica che un elemento funziona correttamente, ma sta stimando un errore, ad esempio un'unità disco rigido abilitata per SMART.

Lo stato non operativo può includere "Error", "starting", "stoping" e "Service". Il "servizio" può essere applicato durante il mirroring del disco, ovvero la riattivazione, il ricaricamento di un elenco di autorizzazioni utente o altre attività amministrative. Non tutto questo lavoro è online, ma l'elemento gestito non è né "OK" né in uno degli altri Stati.

Questa proprietà viene ereditata da CIM _ ManagedSystemElement.

Sono inclusi i valori seguenti:

OK ("OK")

Errore ("errore")

Ridotto ("danneggiato" )

Sconosciuto ("sconosciuto")

Errore di predazione ("Predator fail")

Avvio di ("avvio")

Arresto in corso ("arresto")

Servizio ("servizio")

Sottolineato (sottolineato)

Noncover ("noncover")

Nessun contatto ("nessun contatto")

Comunicazione persa ("comunicazione persa")

SystemVariable

Tipo di dati: Boolean

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32Registry | System \ \ CurrentControlSet \ \ Control \ \ Session Manager \ \ Environment")

Indica se la variabile è una variabile di sistema. Una variabile di sistema viene impostata dal sistema operativo ed è indipendente dalle impostazioni dell'ambiente utente.

UserName

Tipo di dati: String

Tipo di accesso: sola lettura

Qualificatori: Key, maxlen (260), MappingStrings ("Win32Registry | System \ \ CurrentControlSet \ \ Control \ \ Session Manager \ \ Environment")

Nome del proprietario dell'impostazione dell'ambiente. Viene impostato su per le impostazioni specifiche del sistema basato su Windows (in contrapposizione a un utente specifico) e per le impostazioni utente predefinite.

Esempio: "JSmith"

VariableValue

Tipo di dati: String

Tipo di accesso: lettura/scrittura

Qualificatori: MappingStrings ("Win32Registry | System \ \ CurrentControlSet \ \ Control \ \ Session Manager \ \ Environment")

Variabile segnaposto di una variabile di ambiente basata su Windows. Informazioni come la directory file system possono variare da computer a computer. Il sistema operativo sostituisce i segnaposto per questi.

Esempio: "% SystemRoot%"

Commenti

La classe di _ ambiente Win32 è derivata da CIM _ SystemResource. È possibile usare questa classe per trovare i percorsi di cartelle speciali, ad esempio la cartella di sistema o i file di programma in un computer remoto. Di seguito sono riportati alcuni esempi: windir, SystemRoot, ProgramFiles e UserProfile. Win32 _ L'ambiente restituisce sostanzialmente le informazioni disponibili in:

HKEY _ Ambiente _ del \ sistema di \ \ controllo CurrentControlSet \ \ del sistema del computer locale sessionmanager

e

HKEY _ \ Ambiente < utente > utenti \

Il processo chiamante che usa questa classe deve avere il privilegio se _ Restore _ Name nel computer in cui risiede il registro di sistema. Se ad esempio si enumera questa classe nel computer locale, l'account con cui viene eseguita l'applicazione deve disporre di questo privilegio. Per altre informazioni, vedere esecuzione di operazioni con privilegi.

Esempio

Nell'esempio relativo all'elenco delle variabili di ambiente in un computer Perl viene utilizzato WMI per restituire informazioni su tutte le variabili di ambiente in un computer.

Nell'esempio di codice VBScript riportato di seguito vengono enumerate le variabili di ambiente nel computer locale.

strComputer = "."
Set objWMIService = GetObject("winmgmts:\\" & strComputer & "\root\cimv2")
Set colVar = objWMIService.ExecQuery("Select * from Win32_Environment")
For Each objVar in colVar
    Wscript.Echo "Description: " & objVar.Description & VBNewLine _
               & "Name: " & objVar.Name & VBNewLine _
               & "System Variable: " & objVar.SystemVariable & VBNewLine _
               & "User Name: " & objVar.UserName & VBNewLine _
               & "Variable Value: " & objVar.VariableValue 
Next

Nell'esempio di codice VBScript seguente viene modificata una variabile di ambiente denominata BUILD _ Type in un valore di input dell'utente. Lo script presuppone che la variabile del tipo di compilazione _ esista già. Se non esiste, lo script termina. Il valore di input è selezionato: deve essere "Build1", "Build2" o "build3" e non viene accettato alcun altro valore. La funzione UCase di VBScript rende l'input senza distinzione tra maiuscole e minuscole. Se ciò che è digitato non è uno dei tre valori accettabili, lo script termina.

On Error Resume Next
strComputer = "."
Set objWMIService = GetObject("winmgmts:\\" & strComputer & "\root\cimv2")
Set colItems = objWMIService.ExecQuery("Select * from Win32_Environment")
Found = False
For Each objItem in colItems
    If objItem.Name = "BUILD_TYPE" Then
    Found = True
    Change = UCase(InputBox("BUILD_TYPE currently = " & objItem.VariableValue & VBNewLine _
                          & "Change options are Build1, Build2, Build3 "))
        If UCase(Change) = "BUILD1" OR Change = "BUILD2" OR Change = "BUILD3" Then
            objItem.VariableValue = Change
            objItem.Put_
        WScript.Echo "BUILD_TYPE changed to " & objItem.VariableValue
        Else 
        WScript.Echo "No input or unacceptable input." & " No change to BUILD_TYPE"
        End If
    End If
Next
If Found = False Then
    WScript.Echo "User-defined environment variable BUILD_TYPE not found."
End If

Requisiti

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

Vedi anche

_SYSTEMRESOURCE CIM

Classi del sistema operativo