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 |
|
| DLL |
|