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 |
|
| Typbibliothek |
|
| DLL |
|
| CLSID |
CLSID _ SWbemPrivilegeSet |
| IID |
IID _ ISWbemPrivilegeSet |