SWbemPrivilegeSet.AddAsString メソッド

SWbemPrivilegeSet オブジェクトの AddAsString メソッドを使用すると、特権文字列を使用して SWbemPrivilegeSet コレクションに特権を追加できます。 SWbemSecurity オブジェクトの特権を追加したり、特権を有効にしたりするには、このメソッドを使用します。 「VBScript を使用した特権操作の実行」を参照してください。

この構文の詳細については、「スクリプト API のドキュメント規則」を参照してください。

構文

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

パラメーター

strPrivilege

必須。 特権文字列の 1 つ。 これらの文字列および関連する WMI 定数の完全な一覧については、「特権定数」を参照してください。 すべての特権文字列は、特定の特権を表します。 たとえば、コンピューター システムのシャットダウンに使用する特権を追加するには、SeShutdownPrivilege 文字列を使用します。

bIsEnabled [オプション]

この特権を有効または無効にするブール値。 既定値は True です。

戻り値

成功した場合、このメソッドは新しい特権を表す SWbemPrivilege オブジェクトを返します。 それ以外の場合は、null オブジェクトが返されます。

エラー コード

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 のトピックでも説明されています。

要件

関連項目

SWbemPrivilegeSet

SWbemPrivilegeSet.Add

SWbemPrivilegeSet.Remove

WbemPrivilegeEnum

特権定数

特権操作の実行

VBScript を使用した特権操作の実行