Bagikan melalui

kelas Win32_UserAccount

  • Artikel

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
CIMWin32.mof
DLL
CIMWin32.dll

Baca juga

Win32_Account

Kelas Sistem Operasi