SWbemPrivilegeSet.AddAsString-Methode

Sie können die AddAsString-Methode des SWbemPrivilegeSet-Objekts verwenden, um einer SWbemPrivilegeSet-Auflistung mithilfe einer Berechtigungszeichenfolge eine Berechtigung hinzuzufügen. Verwenden Sie diese Methode, um eine Berechtigung hinzuzufügen oder eine Berechtigung für SWbemSecurity-Objekte zu aktivieren. Weitere Informationen finden Sie unter Ausführen privilegierter Vorgänge mit VBScript.

Eine Erläuterung dieser Syntax finden Sie unter Dokumentkonventionen für die Skripterstellungs-API.

Syntax

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

Parameter

strPrivilege

Erforderlich. Eine der Berechtigungszeichenfolgen. Eine vollständige Liste dieser Zeichenfolgen und der zugeordneten WMI-Konstanten finden Sie unter Berechtigungskonstanten. Jede Berechtigungszeichenfolge stellt eine bestimmte Berechtigung dar. Um beispielsweise die Berechtigung hinzuzufügen, die zum Herunterfahren eines Computersystems verwendet, verwenden Sie die Zeichenfolge SeShutdownPrivilege.

bIsEnabled [ Optional]

Boolescher Wert, der diese Berechtigung aktiviert oder deaktiviert. Der Standardwert ist True.

Rückgabewert

Bei Erfolg gibt diese Methode ein SWbemPrivilege-Objekt zurück, das die neue Berechtigung darstellt. Andernfalls wird ein NULL-Objekt zurückgegeben.

Fehlercodes

Nach Abschluss der AddAsString-Methode kann das Err-Objekt den Fehlercode in der folgenden Liste enthalten.

wbemErrFailed – 2147749889 (0x80041001)

Unbekannter Fehler.

Beispiele

Im folgenden VBScript-Codebeispiel wird ein neuer Port für einen Druckserver mit win32 _ TCPIPPrinterPorterstellt. SeLoadDriverPrivilege ist für diesen Vorgang erforderlich. Weitere Informationen finden Sie unter Ausführen privilegierter Vorgänge.

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_

Ein Codebeispiel mit dieser Methode wird auch im Thema SWbemPrivilegeSet beschrieben.

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Vista
Unterstützte Mindestversion (Server)
Windows Server 2008
Header
Wbemdisp.h
Typbibliothek
Wbemdisp.tlb
DLL
Wbemdisp.dll
CLSID
CLSID _ SWbemPrivilegeSet
IID
IID _ ISWbemPrivilegeSet

Weitere Informationen

SWbemPrivilegeSet

SWbemPrivilegeSet.Add

SWbemPrivilegeSet.Remove

WbemPrivilegeEnum

Berechtigungskonstanten

Ausführen privilegierter Vorgänge

Ausführen privilegierter Vorgänge mit VBScript