classe Win32_Group

A classe WMIWin32_Group representa dados sobre uma conta de grupo. Uma conta de grupo permite que privilégios de acesso sejam alterados para uma lista de usuários. Exemplo: Marketing2.

A sintaxe a seguir é simplificada do código MOF (Managed Object Format) e inclui todas as propriedades herdadas. As propriedades são listadas em ordem alfabética, não em ordem MOF.

Sintaxe

[Dynamic, Provider("CIMWin32"), UUID("{8502C4CB-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_Group : Win32_Account
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Status;
  boolean  LocalAccount;
  string   SID;
  uint8    SIDType;
  string   Domain;
  string   Name;
};

Membros

A classe Win32_Group tem estes tipos de membros:

• Métodos
• Propriedades

Métodos

A classe Win32_Group tem esses métodos.

Propriedades

A classe Win32_Group tem essas propriedades.

Legenda

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

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

Uma breve descrição textual do objeto .

Essa propriedade é herdada de CIM_ManagedSystemElement.

Descrição

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: DisplayName ("Description")

Uma descrição textual do objeto .

Essa propriedade é herdada de CIM_ManagedSystemElement.

Domínio

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: Substituição ("Domínio"), MappingStrings ("Win32API| Funções de gerenciamento de rede|domainname")

Nome do domínio do Windows ao qual a conta de grupo pertence.

Exemplo: "NA-SALES"

InstallDate

Tipo de dados: datetime

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Data de Instalação")

Indica quando o objeto foi instalado. A falta de um valor não indica que o objeto não está instalado.

Essa propriedade é herdada de CIM_ManagedSystemElement.

LocalAccount

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: Corrigido

Se TRUE, a conta será definida no computador local. Para recuperar somente contas definidas no computador local, crie uma consulta que inclua a condição "LocalAccount=TRUE".

Essa propriedade é herdada de Win32_Account.

Nome

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: Substituição ("Name"), MappingStrings ("Win32API| Estruturas de gerenciamento de rede|nome")

Nome da conta de grupo do Windows no domínio especificado pela propriedade Domain dessa classe.

SID

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: Fixo, MappingStrings ("Win32API| SIDs (Identificadores de Segurança)")

SID (identificador de segurança) para essa conta. Um SID é um valor de cadeia de caracteres de comprimento variável usado para identificar um administrador. Cada conta tem um SID exclusivo emitido por uma autoridade (como um domínio do Windows), armazenado em um banco de dados de segurança. Quando um usuário faz logon, o sistema recupera o SID do usuário do banco de dados e o coloca no token de acesso do usuário. O sistema usa o SID no token de acesso do usuário para identificar o usuário em todas as interações subsequentes com a segurança do Windows. Quando um SID tiver sido usado como o identificador exclusivo de um usuário ou grupo, ele não poderá ser usado novamente para identificar outro usuário ou grupo.

Essa propriedade é herdada de Win32_Account.

SIDType

Tipo de dados: uint8

Tipo de acesso: Somente leitura

Qualificadores: Fixed, MappingStrings ("Win32API|Controle de Acesso Tipos de enumeração| SID_NAME_USE")

Valores enumerados que especificam o tipo de SID (identificador de segurança).

Essa propriedade é herdada de Win32_Account.

SidTypeUser (1)

SidTypeGroup (2)

SidTypeDomain (3)

SidTypeAlias (4)

SidTypeWellKnownGroup (5)

SidTypeDeletedAccount (6)

SidTypeInvalid (7)

SidTypeUnknown (8)

SidTypeComputer (9)

Comentários

A classe Win32_Group é derivada de Win32_Account.

Exemplos

O código a seguir, obtido do exemplo de código List Local Groups Using WMI VBScript na Galeria do TechNet, usa Win32_Group para retornar informações sobre os grupos locais encontrados em um computador.

On Error Resume Next 
 
strComputer = "." 
Set objWMIService = GetObject("winmgmts:" _ 
    & "{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2") 
Set colItems = objWMIService.ExecQuery _ 
    ("Select * from Win32_Group  Where LocalAccount = True") 
 
For Each objItem in colItems 
    Wscript.Echo "Caption: " & objItem.Caption 
    Wscript.Echo "Description: " & objItem.Description 
    Wscript.Echo "Domain: " & objItem.Domain 
    Wscript.Echo "Local Account: " & objItem.LocalAccount 
    Wscript.Echo "Name: " & objItem.Name 
    Wscript.Echo "SID: " & objItem.SID 
    Wscript.Echo "SID Type: " & objItem.SIDType 
    Wscript.Echo "Status: " & objItem.Status 
    Wscript.Echo 
Next 

Requisitos

Confira também

Win32_Account

Classes do sistema operacional