kelas Win32_Environment

Artikel
09/21/2022
4 menit untuk membaca

Kelas Win32_EnvironmentWMI mewakili lingkungan atau pengaturan lingkungan sistem pada sistem komputer Windows. Mengkueri kelas ini mengembalikan variabel lingkungan yang ditemukan di:

\ HKEY_LOCAL_MACHINE Sistem\CurrentControlSet\Kontrol\Sessionmanager\Lingkungan

dan

\ HKEY_USERS < userEnvironment>\

Sintaks berikut disederhanakan dari kode Managed Object Format (MOF) dan menyertakan semua properti yang diwariskan. Properti tercantum dalam urutan alfabet, bukan urutan MOF.

Sintaks

[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;
};

Anggota

Kelas Win32_Environment memiliki jenis anggota ini:

Properti

Properti

Kelas Win32_Environment memiliki properti ini.

Caption

Jenis data: string
Jenis akses: Baca-saja
Kualifikasi: MaxLen (64), DisplayName ("Keterangan")

Deskripsi tekstual singkat dari objek .

Properti ini diwarisi dari CIM_ManagedSystemElement.

Deskripsi

Jenis data: string
Jenis akses: Baca-saja
Kualifikasi: DisplayName ("Description")

Deskripsi tekstual objek.

Properti ini diwarisi dari CIM_ManagedSystemElement.

InstallDate

Jenis data: tanggalwaktu
Jenis akses: Baca-saja
Kualifikasi: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Tanggal Penginstalan")

Menunjukkan kapan objek diinstal. Kurangnya nilai tidak menunjukkan bahwa objek tidak diinstal.

Properti ini diwarisi dari CIM_ManagedSystemElement.

Nama

Jenis data: string
Jenis akses: Baca/tulis
Kualifikasi: Mengambil alih ("Nama"), kunci, MappingStrings ("Win32Registry| System\\CurrentControlSet\\Control\\Session Manager\\Environment")

String karakter yang menentukan nama variabel lingkungan berbasis Windows. Dengan menentukan nama variabel yang belum ada, aplikasi membuat variabel lingkungan baru.

Contoh: "Jalur"

Status

Jenis data: string
Jenis akses: Baca-saja
Kualifikasi: MaxLen (10), DisplayName ("Status")

String yang menunjukkan status objek saat ini. Status operasional dan non-operasional dapat ditentukan. Status operasional dapat mencakup "OK", "Terdegradasi", dan "Pred Fail". "Pred Fail" menunjukkan bahwa elemen berfungsi dengan baik, tetapi memprediksi kegagalan (misalnya, hard disk drive berkemampuan SMART).

Status non-operasional dapat mencakup "Kesalahan", "Mulai", "Berhenti", dan "Layanan". "Layanan" dapat berlaku selama resilvering cermin disk, memuat ulang daftar izin pengguna, atau pekerjaan administratif lainnya. Tidak semua pekerjaan tersebut online, tetapi elemen terkelola tidak "OK" atau di salah satu status lainnya.

Properti ini diwarisi dari CIM_ManagedSystemElement.

Nilai termasuk yang berikut ini:

OK ("OK")

Kesalahan ("Kesalahan")

Terdegradasi ("Terdegradasi")

Tidak diketahui ("Tidak Diketahui")

Pred Fail ("Pred Fail")

Memulai ("Memulai")

Menghentikan ("Berhenti")

Layanan ("Layanan")

Stres ("Stres")

NonRecover ("NonRecover")

Tidak Ada Kontak ("Tidak Ada Kontak")

Lost Comm ("Lost Comm")

SystemVariable

Jenis data: boolean
Jenis akses: Baca-saja
Kualifikasi: MappingStrings ("Win32Registry| System\\CurrentControlSet\\Control\\Session Manager\\Environment")

Menunjukkan apakah variabel adalah variabel sistem. Variabel sistem diatur oleh sistem operasi, dan independen dari pengaturan lingkungan pengguna.

UserName

Jenis data: string
Jenis akses: Baca-saja
Kualifikasi: key, MaxLen (260), MappingStrings ("Win32Registry| System\\CurrentControlSet\\Control\\Session Manager\\Environment")

Nama pemilik pengaturan lingkungan. Ini diatur ke <SYSTEM> untuk pengaturan yang khusus untuk sistem berbasis Windows (dibandingkan dengan pengguna tertentu) dan <DEFAULT> untuk pengaturan pengguna default.

Contoh: "JSmith"

VariableValue

Jenis data: string
Jenis akses: Baca/tulis
Kualifikasi: MappingStrings ("Win32Registry| System\\CurrentControlSet\\Control\\Session Manager\\Environment")

Variabel tempat penampung dari variabel lingkungan berbasis Windows. Informasi seperti direktori sistem file dapat berubah dari komputer ke komputer. Sistem operasi menggantikan tempat penampung untuk ini.

Contoh: "%SystemRoot%"

Keterangan

Kelas Win32_Environment berasal dari CIM_SystemResource. Anda dapat menggunakan kelas ini untuk menemukan jalur folder khusus seperti folder Sistem atau file Program pada komputer jarak jauh. Beberapa contohnya adalah: windir, systemroot, programfiles, dan userprofile. Win32_Environment pada dasarnya mengembalikan apa yang dapat ditemukan di:

\ HKEY_LOCAL_MACHINE Sistem\CurrentControlSet\Kontrol\Sessionmanager\Lingkungan

dan

\ HKEY_USERS < userEnvironment>\

Proses panggilan yang menggunakan kelas ini harus memiliki hak istimewa SE_RESTORE_NAME pada komputer tempat registri berada. Misalnya, jika Anda menghitung kelas ini di komputer lokal, akun tempat aplikasi Anda berjalan harus memiliki hak istimewa ini. Untuk informasi selengkapnya, lihat Menjalankan Operasi Istimewa.

Contoh

Variabel Lingkungan Daftar pada sampel Computer Perl menggunakan WMI untuk mengembalikan informasi tentang semua variabel lingkungan di komputer.

Contoh kode VBScript berikut menghitung variabel lingkungan di komputer lokal.

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

Contoh kode VBScript berikut mengubah variabel lingkungan bernama BUILD_TYPE menjadi input nilai oleh pengguna. Skrip mengasumsikan bahwa variabel BUILD_TYPE sudah ada. Jika tidak ada maka skrip berakhir. Nilai input diperiksa: nilainya harus "Build1", "Build2", atau "Build3", dan tidak ada nilai lain yang diterima. Fungsi VBScript UCase membuat input tidak peka huruf besar/kecil. Jika apa yang ditik bukan salah satu dari tiga nilai yang dapat diterima, skrip berakhir.

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

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Ruang nama	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Lihat juga

CIM_SystemResource
Kelas Sistem Operasi

kelas Win32_Environment

Sintaks

Anggota

Properti

Keterangan

Contoh

Persyaratan

Lihat juga

Sumber Daya Tambahan:

Sumber Daya Tambahan: