класс Win32_Group

  • Статья

Класс WMIWin32_Group представляет данные об учетной записи группы. Учетная запись группы позволяет изменять права доступа для списка пользователей. Пример: Marketing2.

Следующий пример синтаксиса — упрощенный MOF-код, который включает все наследуемые свойства. Свойства перечислены в алфавитном порядке, а не в порядке MOF.

Синтаксис

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

Члены

Класс Win32_Group имеет следующие типы членов:

Методы

Класс Win32_Group содержит эти методы.

Метод Описание
Переименовать Изменяет имя группы.

Свойства

Класс Win32_Group имеет эти свойства.

Caption

Тип данных: string

Тип доступа: только для чтения

Квалификаторы: MaxLen (64), DisplayName ("Caption")

Краткое текстовое описание объекта.

Это свойство наследуется от CIM_ManagedSystemElement.

Описание

Тип данных: string

Тип доступа: только для чтения

Квалификаторы: DisplayName ("Описание")

Текстовое описание объекта.

Это свойство наследуется от CIM_ManagedSystemElement.

Доменная

Тип данных: string

Тип доступа: только для чтения

Квалификаторы: Override ("Domain"), MappingStrings ("Win32API| | Функции управления сетью|имя_домена")

Имя домена Windows, к которому принадлежит учетная запись группы.

Пример: "NA-SALES"

InstallDate

Тип данных: datetime

Тип доступа: только для чтения

Квалификаторы: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Дата установки")

Указывает, когда был установлен объект . Отсутствие значения не означает, что объект не установлен.

Это свойство наследуется от CIM_ManagedSystemElement.

LocalAccount

Тип данных: boolean

Тип доступа: только для чтения

Квалификаторы: исправлено

Если задано значение TRUE, учетная запись определяется на локальном компьютере. Чтобы получить только учетные записи, определенные на локальном компьютере, создайте запрос, включающий условие LocalAccount=TRUE.

Это свойство наследуется от Win32_Account.

имя;

Тип данных: string

Тип доступа: только для чтения

Квалификаторы: Override ("Name"), MappingStrings ("Win32API| | Структуры управления сетью|имя")

Имя учетной записи группы Windows в домене, заданном свойством Domain этого класса.

SID

Тип данных: string

Тип доступа: только для чтения

Квалификаторы: Fixed, MappingStrings ("Win32API| | Идентификаторы безопасности (SID)")

Идентификатор безопасности (SID) для этой учетной записи. Sid — это строковое значение переменной длины, используемое для идентификации доверенного лица. Каждая учетная запись имеет уникальный идентификатор безопасности, выданный центром сертификации (например, доменом Windows), который хранится в базе данных безопасности. Когда пользователь входит в систему, система получает идентификатор безопасности пользователя из базы данных и помещает его в маркер доступа пользователя. Система использует идентификатор безопасности в маркере доступа пользователя для идентификации пользователя во всех последующих взаимодействиях с безопасностью Windows. Если идентификатор безопасности используется в качестве уникального идентификатора пользователя или группы, его нельзя использовать повторно для идентификации другого пользователя или группы.

Это свойство наследуется от Win32_Account.

SIDType

Тип данных: uint8

Тип доступа: только для чтения

Квалификаторы: Fixed, MappingStrings ("Win32API|контроль доступа Типы перечисления| SID_NAME_USE")

Перечисляемые значения, указывающие тип идентификатора безопасности (SID).

Это свойство наследуется от Win32_Account.

SidTypeUser (1)

SidTypeGroup (2)

SidTypeDomain (3)

SidTypeAlias (4)

SidTypeWellKnownGroup (5)

SidTypeDeletedAccount (6)

SidTypeInvalid (7)

SidTypeUnknown (8)

SidTypeComputer (9)

Состояние

Тип данных: string

Тип доступа: только для чтения

Квалификаторы: MaxLen (10), DisplayName ("Status")

Строка, указывающая текущее состояние объекта. Можно определить рабочее и нерабочем состояние. Состояние работы может включать "ОК", "Понижено" и "Сбой предварительного выполнения". "Pred Fail" означает, что элемент работает правильно, но прогнозирует сбой (например, жесткий диск с поддержкой SMART).

Состояние нерабоспособных может включать "Ошибка", "Запуск", "Остановка" и "Служба". "Служба" может применяться во время зеркало повторного изменения размера диска, перезагрузки списка разрешений пользователя или других административных действий. Не все такие работы доступны в сети, но управляемый элемент не является ни "ОК", ни в одном из других состояний.

Это свойство наследуется от CIM_ManagedSystemElement.

В эти значения входят:

ОК ("ОК")

Ошибка ("Ошибка")

Пониженный ("Пониженный")

Unknown ("Unknown")

Pred Fail ("Pred Fail")

Запуск ("Начало")

Остановка ("Остановка")

Служба ("Служба")

Подчеркнуто ("Подчеркнуто")

NonRecover ("NonRecover")

Нет контакта ("Нет контакта")

Lost Comm ("Lost Comm")

Комментарии

Класс Win32_Group является производным от Win32_Account.

Примеры

Следующий код, взятый из примера перечисления локальных групп с помощью кода WMI VBScript в коллекции TechNet, использует Win32_Group для возврата сведений о локальных группах, найденных на компьютере.

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

Требования

Требование Значение
Минимальная версия клиента
 Windows Vista
Минимальная версия сервера
 Windows Server 2008
Пространство имен
 Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

См. также раздел

Win32_Account

Классы операционной системы