kelas Win32_UserAccount
Kelas WMI Win32_UserAccountberisi informasi tentang akun pengguna pada sistem komputer yang menjalankan Windows.
Catatan
Karena Nama dan Domain adalah properti utama, menghitung Win32_UserAccount pada jaringan besar dapat berdampak negatif pada performa. Memanggil GetObject atau mengkueri untuk instans tertentu memiliki dampak yang lebih sedikit.
Sintaks berikut disederhanakan dari kode Managed Object Format (MOF) dan menyertakan semua properti yang diwariskan. Properti dan metode dalam urutan alfabet, bukan urutan MOF.
Sintaks
[Dynamic, Provider("CIMWin32"), UUID("{8502C4CC-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_UserAccount : Win32_Account
{
uint32 AccountType;
string Caption;
string Description;
boolean Disabled;
string Domain;
string FullName;
datetime InstallDate;
boolean LocalAccount;
boolean Lockout;
string Name;
boolean PasswordChangeable;
boolean PasswordExpires;
boolean PasswordRequired;
string SID;
uint8 SIDType;
string Status;
};
Anggota
Kelas Win32_UserAccount memiliki jenis anggota ini:
Metode
Kelas Win32_UserAccount memiliki metode ini.
| Metode | Deskripsi |
|---|---|
| Ubah nama | Memungkinkan penggantian nama akun pengguna. |
Properti
Kelas Win32_UserAccount memiliki properti ini.
-
AccountType
-
-
Jenis data: uint32
-
Jenis akses: Baca-saja
-
Kualifikasi: MappingStrings ("Win32API|Struktur Manajemen Jaringan|USER_INFO_2|usri2_flags")
Bendera yang menjelaskan karakteristik akun pengguna Windows.
-
-
Akun duplikat sementara (256)
-
UF_TEMP_DUPLICATE_ACCOUNT
Akun pengguna lokal untuk pengguna yang memiliki akun utama di domain lain. Akun ini hanya menyediakan akses pengguna ke domain ini—bukan ke domain apa pun yang mempercayai domain ini.
-
Akun normal (512)
-
UF_NORMAL_ACCOUNT
Jenis akun default yang mewakili pengguna biasa.
-
Akun kepercayaan interdomain (2048)
-
UF_INTERDOMAIN_TRUST_ACCOUNT
Akun untuk domain sistem yang mempercayai domain lain.
-
Akun kepercayaan stasiun kerja (4096)
-
UF_WORKSTATION_TRUST_ACCOUNT
Akun komputer untuk sistem komputer yang menjalankan Windows yang merupakan anggota domain ini.
-
Akun kepercayaan server (8192)
-
UF_SERVER_TRUST_ACCOUNT
Akun untuk pengontrol domain cadangan sistem yang merupakan anggota domain ini.
Caption
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: MaxLen (64), DisplayName ("Keterangan")
Domain dan nama pengguna akun.
Properti ini diwariskan dari CIM_ManagedSystemElement.
Keterangan
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: DisplayName ("Description")
Deskripsi akun.
Properti ini diwariskan dari CIM_ManagedSystemElement.
Nonaktif
-
Jenis data: boolean
-
Jenis akses: Baca/tulis
-
Kualifikasi: MappingStrings ("Win32API|Struktur Manajemen Jaringan|USER_INFO|UF_ACCOUNTDISABLE")
Akun pengguna Windows dinonaktifkan.
Domain
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: Mengambil alih ("Domain"), MappingStrings ("Win32API|Fungsi Manajemen Jaringan|nama domain")
Nama domain Windows tempat akun pengguna berada, misalnya: "NA-SALES".
FullName
-
Jenis data: string
-
Jenis akses: Baca/tulis
-
Kualifikasi: MappingStrings ("Win32API|Struktur Manajemen Jaringan||usri2_full_name USER_INFO_2")
Nama lengkap pengguna lokal, misalnya: "Dan Wilson".
InstallDate
-
Jenis data: tanggalwaktu
-
Jenis akses: Baca-saja
-
Kualifikasi: MappingStrings ("MIF. DMTF|ComponentID|001.5"), DisplayName ("Tanggal Penginstalan")
Tanggal objek diinstal. Properti ini tidak memerlukan nilai untuk menunjukkan bahwa objek diinstal.
Properti ini diwariskan dari CIM_ManagedSystemElement.
LocalAccount
-
Jenis data: boolean
-
Jenis akses: Baca-saja
-
Kualifikasi: Diperbaiki
Jika true, akun didefinisikan pada komputer lokal.
Properti ini diwariskan dari Win32_Account.
Dikunci
-
Jenis data: boolean
-
Jenis akses: Baca/tulis
-
Kualifikasi: MappingStrings ("Win32API|Struktur Manajemen Jaringan||UF_LOCKOUT USER_INFO_2")
Jika true, akun pengguna dikunci dari sistem operasi Windows.
Nama
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: Mengambil alih ("Nama"), MappingStrings ("Win32API|Struktur Manajemen Jaringan|nama")
Nama akun pengguna Windows pada domain yang ditentukan properti Domain kelas ini.
Contoh: "danwilson".
Properti ini diwariskan dari CIM_ManagedSystemElement.
PasswordChangeable
-
Jenis data: boolean
-
Jenis akses: Baca/tulis
-
Kualifikasi: MappingStrings ("Win32API|Struktur Manajemen Jaringan||USER_INFO_2 UF_PASSWD_CANT_CHANGE")
Jika true, kata sandi pada akun pengguna ini dapat diubah.
Kata SandiExpires
-
Jenis data: boolean
-
Jenis akses: Baca/tulis
-
Kualifikasi: MappingStrings ("Win32API|Struktur Manajemen Jaringan||UF_DONT_EXPIRE_PASSWD USER_INFO_2")
Jika true, kata sandi pada akun pengguna ini kedaluwarsa.
PasswordRequired
-
Jenis data: boolean
-
Jenis akses: Baca/tulis
-
Kualifikasi: MappingStrings ("Win32API|Struktur Manajemen Jaringan||UF_PASSWD_NOTREQD USER_INFO_2")
Jika true, kata sandi diperlukan pada akun pengguna Windows. Jika false, akun ini tidak memerlukan kata sandi.
SID
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: Tetap, MappingStrings ("Win32API|Pengidentifikasi Keamanan (SID)")
Pengidentifikasi keamanan (SID) untuk akun ini. SID adalah nilai string dengan panjang variabel yang digunakan untuk mengidentifikasi wali amanat. Setiap akun memiliki SID unik yang menjadi otoritas, seperti domain Windows, masalah. SID disimpan dalam database keamanan. Saat pengguna masuk, sistem mengambil SID pengguna dari database, menempatkan SID dalam token akses pengguna, lalu menggunakan SID dalam token akses pengguna untuk mengidentifikasi pengguna di semua interaksi berikutnya dengan keamanan Windows. Setiap SID adalah pengidentifikasi unik untuk pengguna atau grup, dan pengguna atau grup yang berbeda tidak dapat memiliki SID yang sama.
Properti ini diwariskan dari Win32_Account.
SIDType
-
Jenis data: uint8
-
Jenis akses: Baca-saja
-
Kualifikasi: Tetap, MappingStrings ("Win32API|Tipe Enumerasi Kontrol Akses|SID_NAME_USE")
Nilai enumerasi yang menentukan jenis SID.
Properti ini diwariskan dari Win32_Account.
SidTypeUser (1)
SidTypeGroup (2)
SidTypeDomain (3)
SidTypeAlias (4)
SidTypeWellKnownGroup (5)
SidTypeDeletedAccount (6)
SidTypeInvalid (7)
SidTypeUnknown (8)
SidTypeComputer (9)
Keadaan
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: MaxLen (10), DisplayName ("Status")
Status objek saat ini. Berbagai status operasional dan nonoperasional dapat ditentukan. Status operasional meliputi: "OK", "Degraded", dan "Pred Fail", yang merupakan elemen seperti hard disk drive berkemampuan SMART yang mungkin berfungsi dengan baik, tetapi memprediksi kegagalan dalam waktu dekat. Status nonoperasional meliputi: "Kesalahan", "Mulai", "Berhenti", dan "Layanan", yang dapat berlaku selama resilvering cermin disk, memuat ulang daftar izin pengguna, atau pekerjaan administratif lainnya.
Properti ini diwariskan dari CIM_ManagedSystemElement.
Nilai mencakup yang berikut:
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")
Comm Hilang ("Hilang Comm")
Keterangan
Kelas Win32_UserAccount berasal dari Win32_Account.
Catatan
Kesalahan tidak dikembalikan untuk upaya menulis ke properti baca-saja, dan nilai properti tetap tidak berubah.
Contoh
Contoh kode VBScript berikut menunjukkan kepada Anda cara mendapatkan nama lengkap pengguna di komputer lokal. Nama lengkapnya adalah nama bahasa manusia, misalnya, seseorang mungkin memiliki nama pengguna "kensanchez" dan nama lengkapnya mungkin "Ken Sanchez", jadi Anda mengganti nama domain asli dan nama pengguna untuk "MyDomainName" dan "MyUserName". Untuk kueri yang efisien, Anda harus menentukan properti domain dan nama pengguna.
Jika Anda adalah administrator di komputer jarak jauh, Anda dapat menetapkan nama komputer jarak jauh untuk strComputer (bukan "."), lalu menggunakan jenis skrip berikut untuk mendapatkan nama lengkap akun pengguna di komputer lokal—dari komputer jarak jauh.
On Error Resume Next
strComputer = "."
Set objUserAccount = GetObject("winmgmts{impersonationLevel=impersonate}!\\" & strComputer _
& "\root\cimv2:Win32_UserAccount.Domain='MyDomainName',Name='MyUserName' ")
If Err = 0 Then
WScript.Echo objUserAccount.FullName
Else
WScript.Echo "No object found" & Err.Number
End If
using System.Management;
{
ManagementScope mgmtScope = new ManagementScope("\\\\.\\Root\\CIMv2");
ObjectQuery oQuery = new ObjectQuery("SELECT * FROM Win32_UserAccount Where Name=\"myUserName\"");
ManagementObjectSearcher mgmtSearch = new ManagementObjectSearcher(mgmtScope, oQuery);
ManagementObjectCollection objCollection = mgmtSearch.Get();
foreach (ManagementObject mgmtObject in objCollection)
{
Console.WriteLine("Full Name : {0}", mgmtObject["FullName"]);
}
}
Persyaratan
| Persyaratan | Value |
|---|---|
| Klien minimum yang didukung |
Windows Vista |
| Server minimum yang didukung |
Windows Server 2008 |
| Ruang nama |
Root\CIMV2 |
| MOF |
|
| DLL |
|
Baca juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk