SWbemPrivilegeSet.AddAsString method
Sie können die Methode AddAsString des Objekts SWbemPrivilegeSet verwenden, um einer Sammlung SWbemPrivilegeSet mithilfe einer Berechtigungszeichenfolge eine Berechtigung hinzuzufügen. Verwenden Sie diese Methode, um eine Berechtigung hinzuzufügen oder eine Berechtigung für Objekte SWbemSecurity zu aktivieren. Siehe Ausführen von privilegierten Vorgängen mithilfe von VBScript.
Eine Erläuterung dieser Syntax finden Sie unter Dokumentkonventionen für die Skript-API.
Syntax
objPrivilege = .AddAsString( _
ByVal strPrivilege, _
[ ByVal bIsEnabled ] _
)
Parameter
-
strPrivilege
-
Erforderlich. Eine der Berechtigungszeichenfolgen. Eine vollständige Liste dieser Zeichenfolgen und der zugehörigen 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 wird, verwenden Sie die Zeichenfolge SeShutdownPrivilege.
-
bIsEnabled [optional]
-
Boolescher Wert, der diese Berechtigung aktiviert oder deaktiviert. Der Standardwert ist True.
Rückgabewert
Bei erfolgreicher Ausführung gibt die Methode ein Objekt SWbemPrivilege zurück, das die neue Berechtigung darstellt. Andernfalls wird ein NULL-Objekt zurückgegeben.
Fehlercodes
Nach Abschluss der Methode AddAsString kann das Objekt Err den Fehlercode in der folgenden Liste enthalten.
-
wbemErrFailed – 2147749889 (0x80041001)
-
Unbekannter Fehler.
Beispiele
Im folgenden VBScript-Codebeispiel wird mithilfe von Win32_TCPIPPrinterPort ein neuer Port für einen Druckserver erstellt. Für diesen Vorgang ist das SeLoadDriverPrivilege erforderlich. Siehe Ausführen von privilegierten Vorgängen.
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, das diese Methode verwendet, wird auch im Thema SWbemPrivilegeSet beschrieben.
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 |