Compartir a través de


Método SWbemPrivilegeSet.AddAsString

El método AddAsString del objeto SWbemPrivilegeSet se puede usar para agregar un privilegio a una colección SWbemPrivilegeSet mediante una cadena de privilegios. Este método se usa para agregar un privilegio o para habilitar un privilegio para los objetos SWbemSecurity. Consulte Ejecución de operaciones con privilegios mediante VBScript.

A fin de obtener una explicación de esta sintaxis, vea Convenciones de documentación para la API de scripting.

Sintaxis

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

Parámetros

strPrivilege

Necesario. Una de las cadenas de privilegios. Para ver una lista completa de estas cadenas y las constantes de WMI asociadas, consulte Constantes de privilegios. Cada cadena de privilegios representa un privilegio concreto. Por ejemplo, para agregar el privilegio para apagar un sistema informático se use la cadena SeShutdownPrivilege.

bIsEnabled [opcional]

Valor booleano que habilita o deshabilita este privilegio. El valor predeterminado es True.

Valor devuelto

Si se ejecuta correctamente, este método devuelve un objeto SWbemPrivilege que representa el privilegio nuevo. De lo contrario, se devuelve un objeto null.

Códigos de error

Después de completar el método AddAsString, el objeto Err puede contener el código de error de esta lista.

wbemErrFailed: 2147749889 (0x80041001)

Error no especificado.

Ejemplos

En el siguiente ejemplo de código de VBScript siguiente se crea un puerto para un servidor de impresión mediante Win32_TCPIPPrinterPort. Para esta operación se necesita SeLoadDriverPrivilege. Consulte Ejecución de operaciones con privilegios.

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_

En el tema SWbemPrivilegeSet se describe un ejemplo de código con este método.

Requisitos

Requisito Value
Cliente mínimo compatible
Windows Vista
Servidor mínimo compatible
Windows Server 2008
Encabezado
Wbemdisp.h
Biblioteca de tipos
Wbemdisp.tlb
Archivo DLL
Wbemdisp.dll
CLSID
CLSID_SWbemPrivilegeSet
IID
IID_ISWbemPrivilegeSet

Consulte también

SWbemPrivilegeSet

SWbemPrivilegeSet.Add

SWbemPrivilegeSet.Remove

WbemPrivilegeEnum

Constantes de privilegios

Ejecución de operaciones con privilegios

Ejecución de operaciones con privilegios mediante VBScript