Win32_Service クラスの Create メソッド (CIMWin32 WMI プロバイダー)

CreateWMI クラス メソッドは、新しいシステム サービスを作成します。

このトピックでは、マネージド オブジェクト形式 (MOF) 構文を使用します。 このメソッドの使用方法の詳細については、「メソッドの 呼び出し」を参照してください。

構文

uint32 Create(
  [in] string  Name,
  [in] string  DisplayName,
  [in] string  PathName,
  [in] uint8   ServiceType,
  [in] uint8   ErrorControl,
  [in] string  StartMode,
  [in] boolean DesktopInteract,
  [in] string  StartName,
  [in] string  StartPassword,
  [in] string  LoadOrderGroup,
  [in] string  LoadOrderGroupDependencies[],
  [in] string  ServiceDependencies[]
);

パラメーター

Name [in]

Create メソッドにインストールするサービスの名前。 文字列の最大長は 256 文字です。 Service Control Manager データベースでは文字の大文字と小文字が保持されますが、サービス名の比較では常に大文字と小文字が区別されません。 スラッシュ (/) と 2 つのバックスラッシュ (\) は無効なサービス名文字です。

DisplayName [in]

サービスの表示名。 この文字列の長さは最大 256 文字です。 名前は、Service Control Manager で大文字と小文字が保持されます。 DisplayName の比較では、常に大文字と小文字が区別されません。

制約: Name パラメーターと同じ値を受け入れます。

例: "Atdisk"

PathName [in]

サービスを実装する実行可能ファイルへの完全修飾パス。

例: "\SystemRoot\System32\drivers\afd.sys"

ServiceType [in]

それらを呼び出すプロセスに提供されるサービスの種類。

1 (0x1)

カーネル ドライバー

2 (0x2)

ファイル システム ドライバー

4 (0x4)

アダプター

8 (0x8)

Recognizer ドライバー

16 (0x10)

独自のプロセス

32 (0x20)

共有プロセス

256 (0x100)

対話型プロセス

戻り値

次の一覧に記載されている値の 1 つ、またはエラーを示すその他の値を返します。 その他のエラー コードについては、「 WMI エラー定数 」または 「WbemErrorEnum」を参照してください。 一般的な HRESULT 値については、「 システム エラー コード」を参照してください。

0

要求が受け入れられました。

1

要求はサポートされていません。

2

ユーザーは必要なアクセス権を持っていませんでした。

3

そのサービスは、実行中の他のサービスが依存しているので停止できません。

4

要求された制御コードは有効でないか、またはサービスを受け入れ可能ではありません。

5

サービスの状態 (Win32_BaseService クラスの State プロパティ) が 0、1、または 2 であるため、要求された制御コードをサービスに送信できません。

6

サービスは開始されていません。

7

サービスは適切な時間内に開始要求に応答しませんでした。

8

サービスの開始時に不明なエラーが発生しました。

9

サービス実行可能ファイルへのディレクトリ パスが見つかりませんでした。

"10"

サービスは既に実行されています。

11

新しいサービスを追加するデータベースはロックされています。

12

このサービスが依存する依存関係がシステムから削除されました。

13

サービスは依存関係のあるサービスから必要なサービスを見つけられませんでした。

14

サービスはシステムから無効になっています。

15

サービスにはシステムで実行するための正しい認証がありません。

16

このサービスはシステムから削除されています。

17

サービスに実行スレッドがありません。

18

サービスは起動時に循環依存関係を持ちます。

19

サービスは同じ名前で実行されています。

20

サービス名に無効な文字が含まれています。

21

無効なパラメーターがサービスに渡されました。

22

このサービスを実行するアカウントが無効であるか、サービスを実行するためのアクセス許可がありません。

23

サービスは、システムから利用できるサービスのデータベースにあります。

24

サービスは現在システムで一時停止されています。

注釈

サービスは通常、オペレーティング システムのインストールの一部として、またはサービス開発者によって提供されるインストール プログラムを使用して、2 つの方法のいずれかでインストールされます。 ただし、一部のサービス (特に社内で作成されたもの) にはインストール プログラムがない場合があります。 これらのインスタンスでは、 Create メソッドを使用してプログラムでサービスをインストールできます。

名前にもかかわらず、Create メソッドは実際にはサービスを作成しません。既存のサービスをインストールするだけです。 このコマンドを使用するには、サービス実行可能ファイルをコンピューターにコピーし、 Create を使用してサービスをインストールする必要があります。

Create メソッドは Change メソッドに似ています。 どちらの場合も、サービスのプロパティは パラメーターとして メソッドに渡されます。 Change メソッドで使用されるパラメーターと同様に、これらのパラメーターが渡される順序は非常に重要です。

LoadOrderGroup パラメーターは、実行依存関係を定義するシステム サービスのグループを表します。 サービスは相互に依存するため、ロード注文グループで指定された順序でサービスを開始する必要があります。 これらの依存サービスが正しく機能するには、継続元サービスが存在する必要があります。

例

次の VBScript では、DbService という名前のサービスがインストールされます

Const OWN_PROCESS = 16
Const NOT_INTERACTIVE = True
strComputer = "."
Set objWMIService = GetObject("winmgmts:" _
 & "{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set objService = objWMIService.Get("Win32_BaseService")
errReturn = objService.Create ("DbService", "Personnel Database", _
"c:\windows\system32\db.exe", OWN_PROCESS ,2 ,"Automatic" , _
 NOT_INTERACTIVE ,".\LocalSystem" ,"")

要件

こちらもご覧ください

オペレーティング システム クラス

Win32_Service

WMI タスク: サービス