classe Win32_Group

Artigo
06/12/2023

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.

Método	Descrição
Renomear	Altera o nome do grupo.

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)

Status

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: MaxLen (10), DisplayName ("Status")

Cadeia de caracteres que indica o status atual do objeto. As status operacionais e não operacionais podem ser definidas. Os status operacionais podem incluir "OK", "Degradado" e "Falha de Pred". "Pred Fail" indica que um elemento está funcionando corretamente, mas está prevendo uma falha (por exemplo, uma unidade de disco rígido habilitada para SMART).

As status não operacionais podem incluir "Erro", "Iniciando", "Parando" e "Serviço". O "Serviço" pode ser aplicado durante o disco espelho-resilvering, recarregando uma lista de permissões de usuário ou outro trabalho administrativo. Nem todo esse trabalho está online, mas o elemento gerenciado não é "OK" nem em um dos outros estados.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Os valores incluem o seguinte:

OK ("OK")

Erro ("Erro")

Degradado ("Degradado")

Desconhecido ("Desconhecido")

Pred Fail ("Pred Fail")

Iniciando ("Iniciando")

Parando ("Parando")

Serviço ("Serviço")

Estressado ("Estressado")

NonRecover ("NonRecover")

Sem Contato ("Sem Contato")

Lost Comm ("Lost Comm")

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

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Namespace	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Confira também

Win32_Account
Classes do sistema operacional

Compartilhar via

classe Win32_Group

Sintaxe

Membros

Métodos

Propriedades

Comentários

Exemplos

Requisitos

Confira também

Comentários

Recursos adicionais