класс Win32_Share

  • Статья

Класс Win32_Share представляет общий ресурс в компьютерной системе под управлением Windows. Это может быть диск, принтер, межпроцессное взаимодействие или другое совместно используемое устройство. Дополнительные сведения о получении классов WMI см. в разделе Извлечение класса.

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

Синтаксис

[Dynamic, Provider("CIMWin32"), UUID("{8502C4D6-5FBB-11D2-AAC1-006008C78BC7}"), SupportsCreate, CreateBy("Create"), SupportsDelete, DeleteBy("DeleteInstance"), AMENDMENT]
class Win32_Share : CIM_LogicalElement
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Status;
  uint32   AccessMask;
  boolean  AllowMaximum;
  uint32   MaximumAllowed;
  string   Name;
  string   Path;
  uint32   Type;
};

Члены

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

Методы

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

Метод Описание
Создать Метод класса, инициирующий общий доступ к ресурсу сервера.
Удалить Метод класса, который удаляет имя общей папки из списка общих ресурсов сервера, отключая подключения к общему ресурсу.
GetAccessMask Возвращает права доступа к общей папке, которой принадлежит пользователь или группа, от имени которой возвращается экземпляр . Этот метод следует использовать вместо свойства AccessMask , которое всегда имеет значение NULL.
SetShareInfo Метод класса, который задает параметры общего ресурса.

 

Свойства

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

AccessMask

Тип данных: uint32

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

Квалификаторы: НЕ РЕКОМЕНДУЕТСЯ

Это свойство устарело и больше не используется. Вместо этого используйте метод Win32_Share.GetAccessMask . WMI задает значение null для свойства AccessMask. Дополнительные сведения о настройке доступа при создании общей папки см. в разделе Метод Create .

AllowMaximum

Тип данных: boolean

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

Квалификаторы: MappingStrings ("Win32API| | Структуры управления сетями | SHARE_INFO_502|shi502_max_uses")

Количество одновременных пользователей для этого ресурса ограничено. Если задано значение True, значение свойства MaximumAllowed игнорируется.

Caption

Тип данных: string

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

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

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

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

Описание

Тип данных: string

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

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

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

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

InstallDate

Тип данных: datetime

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

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

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

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

MaximumAllowed

Тип данных: uint32

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

Квалификаторы: MappingStrings ("Win32API| | Структуры управления сетями | SHARE_INFO_502|shi502_max_uses")

Ограничение максимального числа пользователей, которым разрешено использовать этот ресурс одновременно. Значение допустимо, только если свойству AllowMaximum присвоено значение FALSE.

имя;

Тип данных: string

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

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

Псевдоним, заданный для пути, настроенного в качестве общей папки в компьютерной системе под управлением Windows.

Пример Windows 2008: "\SERVER01\public" — Windows Server 2008 требует, чтобы UNC был в имени.

Путь

Тип данных: string

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

Квалификаторы: MappingStrings ("Win32API| | Структуры управления сетями | SHARE_INFO_502|shi502_path")

Локальный путь к общей папке Windows.

Пример: "C:\Program Files"

Состояние

Тип данных: string

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

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

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

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

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

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

ОК ("ОК")

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

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

Unknown ("Unknown")

Pred Fail ("Pred Fail")

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

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

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

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

NonRecover ("NonRecover")

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

Lost Comm ("Lost Comm")

Тип

Тип данных: uint32

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

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

Тип ресурса, к которым предоставляется общий доступ. К типам относятся диски, очереди печати, межпроцессные коммуникации (IPC) и устройства общего назначения.

Диск (0)

Очередь печати (1)

Устройство (2)

IPC (3)

Администратор диска (2147483648)

Администратор очереди печати (2147483649)

Администратор устройства (2147483650)

IPC Администратор (2147483651)

Комментарии

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

Метод Create в этом классе является статическим методом. Методы Delete, GetAccessMask и SetShareInfo являются методами экземпляра.

В зависимости от разрешений безопасности вы можете не получить все свойства этого класса. Например, свойства AllowMaximum, MaximumAllowed, Path и Type могут возвращать значение NULL. Как правило, опытные пользователи и администраторы смогут извлекать все значения свойств.

Примеры

В следующемпримере кода центра сценариев перечислены все общие папки на компьютере и перечислены все разрешения общего ресурса для каждой общей папки.

Получение сведений об общем ресурсе, аналогичное примеру Win32_Share PowerShell, Win32_Share и предоставляет результаты.

В следующем примере PowerShell отображаются общие папки в локальной системе.

$shares = Get-WMIObject -class Win32_share
"Shares on : {0}" -f $((gwmi win32_computersystem).name)
$shares | sort name | ft -auto

Кроме того, если вы хотите более точно отфильтровать, можно использовать следующий фрагмент кода PowerShell:

gwmi -q "SELECT * FROM Win32_Share WHERE Name != 'ADMIN$' AND Name != 'IPC$'"

В следующем примере VBScript отображаются общие папки в локальной системе.

strComputer = "." 
Set objWMIService = GetObject("winmgmts:\\" & strComputer & "\root\CIMV2") 
Set colItems = objWMIService.ExecQuery("SELECT * FROM Win32_Share")


For Each objItem in colItems 
 Wscript.Echo "Name: " & objItem.Name
 Wscript.Echo "Caption: " & objItem.Caption & "=" & objItem.Path
Next

Требования

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

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

CIM_LogicalElement

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

Задачи WMI: файлы и папки