wrapper.ntservice.account プロパティ

対応バージョン :3.0.0
対応エディション :プロフェッショナル版スタンダード版コミュニティー版
対応プラットフォーム :WindowsMac OSX (未対応)Linux (未対応)IBM AIX (未対応)FreeBSD (未対応)HP-UX (未対応)Solaris (未対応)IBM z/OS (未対応)IBM z/Linux (未対応)

警告

コンフィギュレーションファイルを使って、 アプリケーションを Windows サービスとしてインストールしている場合、このプロパティ値を変更しないでください。 このプロパティ値を変更する前に、必ずアプリケーションを既存サービスからアンインストールしてください。 後に、新しい設定値で、サービスを安全に再インストールすることができます。

このプロパティは、Windows プラットフォームで使われるプロパティです。

アカウント設定:

このプロパティには、サービスを動かすときに利用するアカウントを設定します。 次の形式で、アカウント名を使います:「{DomainName}\{UserName}」。 もしアカウントがビルトインドメインに属する場合、 次の形式で、名前を指定することもできます:「.\{UserName}」 デフォルト値、「ブランク(空値)」、では「LocalSystem」アカウントを利用します。

設定例:
wrapper.ntservice.account=.\leif

パスワード設定:

ほとんどのアカウントにはパスワードが必要です。 パスワードを指定する様々なオプションとして、 [wrapper.ntservice.password] プロパティをご覧ください。

サービスインストール時のエラー:

サービスをインストールする際に、アカウント名が無効になっている場合や存在しない場合、あるいは、 パスワードが不正な場合、下記のメッセージに遭遇することがあります。 よくある一般的な間違いの例は、アカウント名を、 本来『.\leif』とするところを 『leif』と設定してしまうことです。

CreateService failed - The account name is invalid or does not exist,
or the password is invalid for the account name specified. (0x421)

さらに、「サービスとしてのログオン」権限が設定されているアカウントのみを使用してサービスを実行できます。 この権利を設定しないと、サービスをインストールしようとしたときに次のエラーメッセージが表示されます。

 Authentication attempt failed - Logon failure: the user has not been granted the requested logon type at this computer. (0x569)

注意

バージョン 3.5.8 より、Wrapper がサービスインストール時に自動的に「サービスとしてのログオン」権限を設定します。

バージョン 3.5.44 より、[wrapper.ntservice.account.logon_as_service]プロパティを利用すると、 その権限を追加するかしないかを制限できます。

システムにアクセス権限の設定:

『サービスとしてログオンする』権限を設定するには、 コントロールパネルにある『管理ツール』に行き、『ローカルセキュリティポリシー』を開きます。 『ローカルポリシー』を展開させて、『ユーザー権限の割り当て』をクリックします。 ウィンドウの右側に、『サービスとしてログオン』の項目が見えるはずです。 右クリックか、ダブルクリックで、プロパティダイアログにアクセスして、 「サービスを動かす許可するユーザー」を追加設定します。

Windows のホームエディションでは、ローカルセキュリティポリシー設定画面は表示できないようです。

注意

もし、このプロパティで、特定のアカウントを使ってサービスを動かすように設定されている場合、 [wrapper.ntservice.interactive] プロパティを「FALSE」に設定しなければなりません。

注意

このプロパティを変更した場合、Windowsサービスを再インストールするまで有効になりません。

次のどれかの値を利用して、アカウントにシステムアカウントの代替えを設定することが可能です:

設定例:
wrapper.ntservice.account=NT AUTHORITY\NetworkService
wrapper.ntservice.account=NT AUTHORITY\LocalService

さらに情報は、マイクロソフトのMSDNページ 『Network サービス アカウント』 を参照ください。

参照: アカウント関連