Classe Win32_UserAccount

  • Articolo

La classe WMI Win32_UserAccountcontiene informazioni su un account utente in un sistema computer che esegue Windows.

Nota

Poiché sia il nome che il dominio sono proprietà chiave, l'enumerazione Win32_UserAccount in una rete di grandi dimensioni può influire negativamente sulle prestazioni. La chiamata a GetObject o l'esecuzione di query per un'istanza specifica ha un impatto minore.

 

La sintassi seguente è semplificata dal codice MOF (Managed Object Format) e include tutte le proprietà ereditate. Le proprietà e i metodi sono in ordine alfabetico, non in ordine MOF.

Sintassi

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

Membri

La classe Win32_UserAccount ha questi tipi di membri:

Metodi

La classe Win32_UserAccount dispone di questi metodi.

Metodo Descrizione
Rinomina Consente la ridenominazione dell'account utente.

 

Proprietà

La classe Win32_UserAccount ha queste proprietà.

AccountType

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API|Strutture di gestione della rete |U edizione StandardR_INFO_2|usri2_flags")

Flag che descrivono le caratteristiche di un account utente di Windows.

Account duplicato temporaneo (256)

UF_TEMP_DUPLICATE_ACCOUNT

Account utente locale per gli utenti che hanno un account primario in un altro dominio. Questo account fornisce l'accesso utente solo a questo dominio, non a qualsiasi dominio che consideri attendibile questo dominio.

Conto normale (512)

UF_NORMAL_ACCOUNT

Tipo di account predefinito che rappresenta un utente tipico.

Account trust tra domini (2048)

UF_INTERDOMAIN_TRUST_ACCOUNT

Account per un dominio di sistema che considera attendibili altri domini.

Account trust workstation (4096)

UF_WORKSTATION_TRUST_ACCOUNT

Account computer per un sistema computer che esegue Windows membro di questo dominio.

Account trust server (8192)

UF_edizione StandardRVER_TRUST_ACCOUNT

Account per un controller di dominio di backup di sistema membro di questo dominio.

Caption

Tipo di dati: string

Tipo di accesso: sola lettura

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

Dominio e nome utente dell'account.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Descrizione

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: DisplayName ("Description")

Descrizione dell'account.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Disabilitato

Tipo di dati: booleano

Tipo di accesso: lettura/scrittura

Qualificatori: MappingStrings ("Win32API|Strutture di gestione della rete |U edizione StandardR_INFO |UF_ACCOUNTDISABLE")

L'account utente di Windows è disabilitato.

Dominio

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: Override ("Dominio"), MappingStrings ("Win32API|Funzioni di gestione di rete|nomedominio")

Nome del dominio di Windows a cui appartiene un account utente, ad esempio: "NA-SALES".

FullName

Tipo di dati: string

Tipo di accesso: lettura/scrittura

Qualificatori: MappingStrings ("Win32API|Strutture di gestione della rete |U edizione StandardR_INFO_2|usri2_full_name")

Nome completo di un utente locale, ad esempio: "Dan Wilson".

InstallDate

Tipo di dati: datetime

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("MIF. DMTF |ComponentID|001.5"), DisplayName ("Data di installazione")

Data di installazione dell'oggetto. Questa proprietà non richiede un valore per indicare che l'oggetto è installato.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

LocalAccount

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: fisso

Se true, l'account viene definito nel computer locale.

Questa proprietà viene ereditata da Win32_Account.

Blocco

Tipo di dati: booleano

Tipo di accesso: lettura/scrittura

Qualificatori: MappingStrings ("Win32API|Strutture di gestione della rete |U edizione StandardR_INFO_2|UF_LOCKOUT")

Se true, l'account utente viene bloccato dal sistema operativo Windows.

Nome

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: Override ("Name"), MappingStrings ("Win32API|Strutture di gestione di rete|nome")

Nome dell'account utente di Windows nel dominio specificato dalla proprietà Domain di questa classe.

Esempio: "danwilson".

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

PasswordChangeable

Tipo di dati: booleano

Tipo di accesso: lettura/scrittura

Qualificatori: MappingStrings ("Win32API|Strutture di gestione della rete |U edizione StandardR_INFO_2|UF_PASSWD_CANT_CHANGE")

Se true, la password dell'account utente può essere modificata.

PasswordExpires

Tipo di dati: booleano

Tipo di accesso: lettura/scrittura

Qualificatori: MappingStrings ("Win32API|Strutture di gestione della rete |U edizione StandardR_INFO_2|UF_DONT_EXPIRE_PASSWD")

Se true, la password dell'account utente scade.

PasswordRequired

Tipo di dati: booleano

Tipo di accesso: lettura/scrittura

Qualificatori: MappingStrings ("Win32API|Strutture di gestione della rete |U edizione StandardR_INFO_2|UF_PASSWD_NOTREQD")

Se true, è necessaria una password in un account utente di Windows. Se false, questo account non richiede una password.

SID

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: Fixed, MappingStrings ("Win32API|Identificatori di sicurezza (SID)")

Identificatore di sicurezza (SID) per questo account. Un SID è un valore stringa di lunghezza variabile usato per identificare un trustee. Ogni account ha un SID univoco che un'autorità, ad esempio un dominio di Windows, rilascia. Il SID viene archiviato nel database di sicurezza. Quando un utente accede, il sistema recupera il SID utente dal database, inserisce il SID nel token di accesso utente e quindi usa il SID nel token di accesso utente per identificare l'utente in tutte le interazioni successive con la sicurezza di Windows. Ogni SID è un identificatore univoco per un utente o un gruppo e un utente o un gruppo diverso non può avere lo stesso SID.

Questa proprietà viene ereditata da Win32_Account.

SIDType

Tipo di dati: uint8

Tipo di accesso: sola lettura

Qualificatori: Fixed, MappingStrings ("Win32API|Controllo di accesso Tipi di enumerazione |SID_NAME_Uedizione Standard")

Valore enumerato che specifica il tipo di SID.

Questa proprietà viene ereditata da Win32_Account.

SidTypeUser (1)

SidTypeGroup (2)

SidTypeDomain (3)

SidTypeAlias (4)

SidTypeWellKnownGroup (5)

SidTypeDeletedAccount (6)

SidTypeInvalid (7)

SidTypeUnknown (8)

SidTypeComputer (9)

Stato

Tipo di dati: string

Tipo di accesso: sola lettura

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

Stato corrente di un oggetto. È possibile definire vari stati operativi e non operativi. Gli stati operativi includono: "OK", "Degraded" e "Pred Fail", che è un elemento come un'unità disco rigido abilitata per SMART che potrebbe funzionare correttamente, ma prevede un errore nel prossimo futuro. Gli stati non operativi includono: "Error", "Starting", "Stopping" e "Service", che può essere applicato durante il ridimensionamento mirror di un disco, ricaricando un elenco di autorizzazioni utente o altre attività amministrative.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Sono inclusi i valori seguenti:

OK ("OK ")

Errore ("Errore ")

Degradato ("degradato")

Sconosciuto ("Sconosciuto")

Pred Fail ("Pred Fail ")

Avvio ("Starting ")

Arresto ("arresto ")

Servizio ("Servizio")

Sottolineato ("sottolineato ")

NonRecover ("NonRecover ")

Nessun contatto ("Nessun contatto ")

Lost Comm ("Lost Comm ")

Osservazioni:

La classe Win32_UserAccount deriva da Win32_Account.

Nota

Non viene restituito un errore per un tentativo di scrittura in una proprietà di sola lettura e il valore della proprietà rimane invariato.

 

Esempi

Nell'esempio di codice VBScript seguente viene illustrato come ottenere il nome completo di un utente in un computer locale. Il nome completo è il nome della lingua umana, ad esempio, una persona può avere il nome utente "kensanchez" e il nome completo può essere "Ken Sanchez", quindi sostituire il nome di dominio reale e il nome utente per "MyDomainName" e "MyUserName". Per una query efficiente, è necessario specificare sia le proprietà del dominio che del nome utente.

Se si è un amministratore in un computer remoto, è possibile assegnare il nome del computer remoto per strComputer (invece di ".") e quindi usare il tipo di script seguente per ottenere il nome completo di un account utente in un computer locale, da un computer remoto.

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"]);
     }
}

Requisiti

Requisito valore
Client minimo supportato
 Windows Vista
Server minimo supportato
 Windows Server 2008
Spazio dei nomi
 Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

Vedi anche

Win32_Account

Classi del sistema operativo