Win32 _ Environment-Klasse

Die WMI-Klasse "Win32-Umgebung" _ stellt eine Umgebungs- oder Systemumgebungseinstellung auf einem Windows-Computersystem dar. Beim Abfragen dieser Klasse werden Umgebungsvariablen zurückgegeben, die sich in folgenden Bereichen befinden:

HKEY _ LOCAL _ MACHINE \ System \ CurrentControlSet \ Control \ Sessionmanager \ Environment

and

HKEY _ \ < BENUTZERbenutzerumgebung > \

Die folgende Syntax wurde aus MOF-Code (Managed Object Format, verwaltetes Objektformat) vereinfacht und enthält alle geerbten Eigenschaften. Eigenschaften werden in alphabetischer Reihenfolge und nicht in MOF-Reihenfolge aufgeführt.

Syntax

[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

Die Win32 _ Environment-Klasse verfügt über diese Typen von Membern:

Eigenschaften

Die _ Win32-Umgebungsklasse verfügt über diese Eigenschaften.

Caption

Datentyp: string

Zugriffstyp: Schreibgeschützt

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

Eine kurze Textbeschreibung des Objekts.

Diese Eigenschaft wird von CIM _ ManagedSystemElementgeerbt.

Beschreibung

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: DisplayName ("Beschreibung")

Eine Textbeschreibung des -Objekts.

Diese Eigenschaft wird von CIM _ ManagedSystemElementgeerbt.

InstallDate

Datentyp: datetime

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("MIF. DMTF | ComponentID | 001.5"), DisplayName ("Installationsdatum")

Gibt an, wann das Objekt installiert wurde. Das Fehlen eines Werts gibt nicht an, dass das Objekt nicht installiert ist.

Diese Eigenschaft wird von CIM _ ManagedSystemElementgeerbt.

Name

Datentyp: string

Zugriffstyp: Lesen/Schreiben

Qualifizierer: Überschreiben ("Name"), Schlüssel, MappingStrings ("Win32Registry | System \ \ CurrentControlSet \ \ Control Session Manager \ \ \ \ Environment")

Zeichenfolge, die den Namen einer Windows-basierten Umgebungsvariablen angibt. Durch Angeben des Namens einer noch nicht vorhandenen Variablen erstellt eine Anwendung eine neue Umgebungsvariable.

Beispiel: "Path"

Status

Datentyp: string

Zugriffstyp: Schreibgeschützt

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

Zeichenfolge, die den aktuellen Status des Objekts angibt. Der Betriebsstatus und der nicht betriebsbereite Status können definiert werden. Der Betriebsstatus kann "OK", "Heruntergestuft" und "Fehler vor dem Ausfall" enthalten. "Pred Fail" gibt an, dass ein Element ordnungsgemäß funktioniert, aber einen Fehler vorhersagt (z. B. ein SMART-fähiges Festplattenlaufwerk).

Nicht betriebsbereite Status können "Error", "Starting", "Stopping" und "Service" sein. "Dienst" kann während der Datenträgerspiegelung, beim erneuten Laden einer Benutzerberechtigungsliste oder bei anderen Administrativen Arbeiten angewendet werden. Nicht alle dieser Arbeiten sind online, aber das verwaltete Element ist weder "OK" noch in einem der anderen Zustände.

Diese Eigenschaft wird von CIM _ ManagedSystemElementgeerbt.

Folgende Werte sind gültig:

OK ("OK")

Fehler ("Fehler")

Heruntergestuft ("Heruntergestuft")

Unbekannt ("Unbekannt")

Pred Fail ("Pred Fail")

Wird gestartet ("Wird gestartet")

Beenden ("Wird beendet")

Dienst ("Dienst")

1600000000000

NonRecover ("NonRecover")

Kein Kontakt ("Kein Kontakt")

Verlorenes Komma ("Verlorenes Komma")

SystemVariable

Datentyp: boolescher Wert

Zugriffstyp: Schreibgeschützt

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

Gibt an, ob die Variable eine Systemvariable ist. Eine Systemvariable wird vom Betriebssystem festgelegt und ist unabhängig von den Einstellungen der Benutzerumgebung.

UserName

Datentyp: string

Zugriffstyp: Schreibgeschützt

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

Name des Besitzers der Umgebungseinstellung. Sie ist < für Einstellungen, die für > das Windows-basierte System spezifisch sind (im Gegensatz zu einem bestimmten Benutzer), auf SYSTEM und < für > Standardbenutzereinstellungen auf DEFAULT festgelegt.

Beispiel: "JSmith"

VariableValue

Datentyp: string

Zugriffstyp: Lesen/Schreiben

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

Platzhaltervariable einer Windows-basierten Umgebungsvariablen. Informationen wie das Dateisystemverzeichnis können sich von Computer zu Computer ändern. Das Betriebssystem ersetzt Platzhalter für diese.

Beispiel: "%SystemRoot%"

Bemerkungen

Die _ Win32-Umgebungsklasse wird von CIM _ SystemResourceabgeleitet. Sie können diese Klasse verwenden, um die Pfade von speziellen Ordnern zu suchen, z. B. den Ordner System oder Programme auf einem Remotecomputer. Beispiele: windir, systemroot, programfiles und userprofile. Win32 _ Die Umgebung gibt im Grunde zurück, was in zu finden ist:

HKEY _ LOCAL _ MACHINE \ System \ CurrentControlSet \ Control \ Sessionmanager \ Environment

and

HKEY _ \ < BENUTZERbenutzerumgebung > \

Der aufrufende Prozess, der diese Klasse verwendet, muss über die SE _ RESTORE _ NAME-Berechtigung auf dem Computer verfügen, auf dem sich die Registrierung befindet. Wenn Sie diese Klasse beispielsweise auf dem lokalen Computer aufzählen, muss das Konto, unter dem Die Anwendung ausgeführt wird, über diese Berechtigung verfügen. Weitere Informationen finden Sie unter Ausführen privilegierter Vorgänge.

Beispiele

Das Beispiel Zum Auflisten von Umgebungsvariablen auf einem Computer Perl verwendet WMI, um Informationen zu allen Umgebungsvariablen auf einem Computer zurück zu geben.

Im folgenden VBScript-Codebeispiel werden die Umgebungsvariablen auf dem lokalen Computer aufzählt.

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

Im folgenden VBScript-Codebeispiel wird eine Umgebungsvariable mit dem Namen BUILD _ TYPE in eine Werteingabe des Benutzers geändert. Das Skript geht davon aus, dass die BUILD _ TYPE-Variable bereits vorhanden ist. Wenn es nicht vorhanden ist, wird das Skript beendet. Der Eingabewert wird überprüft: Er muss entweder "Build1", "Build2" oder "Build3" sein, und es wird kein anderer Wert akzeptiert. Die VBScript-UCase-Funktion berücksichtigt die Groß-/Kleinschreibung der Eingabe nicht. Wenn es sich bei dem Typ nicht um einen der drei zulässigen Werte handelt, wird das Skript beendet.

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

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Vista
Unterstützte Mindestversion (Server)
Windows Server 2008
Namespace
\Stamm-CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

Weitere Informationen

CIM _ SystemResource

Betriebssystemklassen