Метод SWbemPrivilegeSet.AddAsString

Метод AddAsString объекта SWbemPrivilegeSet можно использовать для добавления привилегий в коллекцию SWbemPrivilegeSet с помощью строки привилегий. Используйте этот метод для добавления привилегий или включения привилегий для объектов SWbemSecurity . См. раздел "Выполнение привилегированных операций с помощью VBScript".

Описание этого синтаксиса см. в разделе "Соглашения о документах" для API скриптов.

Синтаксис

objPrivilege = .AddAsString( _
  ByVal strPrivilege, _
  [ ByVal bIsEnabled ] _
)

Параметры

strPrivilege

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

bIsEnabled [необязательно]

Логическое значение, которое включает или отключает эту привилегию. По умолчанию используется значение True.

Возвращаемое значение

В случае успешного выполнения этот метод возвращает объект SWbemPrivilege , представляющий новую привилегию. В противном случае возвращается пустой объект.

Коды ошибок

После завершения метода AddAsString объект Err может содержать код ошибки в следующем списке.

wbemErrFailed — 2147749889 (0x80041001)

Незаданная ошибка.

Примеры

В следующем примере кода VBScript создается новый порт для сервера печати с помощью Win32_TCPIPPrinterPort. Для этой операции требуется SeLoadDriverPrivilege . См. раздел "Выполнение привилегированных операций".

Set objWMIService = GetObject("Winmgmts:")
objWMIService.Security_.Privileges. _
    AddAsString "SeLoadDriverPrivilege", True
Set objNewPort = objWMIService.Get _
    ("Win32_TCPIPPrinterPort").SpawnInstance_
objNewPort.Name = "IP_111.222.111.11"
objNewPort.Protocol = 1
objNewPort.HostAddress = "111.222.111.11"
objNewPort.PortNumber = "9999"
objNewPort.SNMPEnabled = False
objNewPort.Put_

Пример кода, использующий этот метод, также описан в разделе SWbemPrivilegeSet .

Требования

Требование Значение
Минимальная версия клиента
Windows Vista
Минимальная версия сервера
Windows Server 2008
Заголовок
Wbemdisp.h
Библиотека типов
Wbemdisp.tlb
DLL
Wbemdisp.dll
CLSID
CLSID_SWbemPrivilegeSet
IID
IID_ISWbemPrivilegeSet

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

SWbemPrivilegeSet

SWbemPrivilegeSet.Add

SWbemPrivilegeSet.Remove

WbemPrivilegeEnum

Константы привилегий

Выполнение привилегированных операций

Выполнение привилегированных операций с помощью VBScript