2.11.2　create-system-properties

書式

asadmin [asadmin-options] create-system-properties [--help]
    [--target target] [name=value[:name=value]...]

格納先

Application Serverインストールディレクトリー/javaee/glassfish/bin

機能

create-system-propertiesサブコマンドは、サーバの各所から参照できる各システムプロパティーを追加または更新します。

Java EE Serverには、各トークン（システムプロパティー）を指定できるフックが用意されています。Java EE Serverには複数サーバ要素がないので、任意のレベルで特定のトークンを指定できます。ドメインが複数サーバをサポートするとき、優先原則が悪用されるおそれがあります。

ドメインが起動または再起動されるとき、すべてのsystem-property要素はSystem.setProperty()呼び出しによって解決され、Java VMで利用できるようになります（要素の名前と値は、対応する要素属性から抽出されます）。この機能は、Javaのコマンドラインを使用して、要素を-Dパラメーターとして送信する機能に類似しています。

このサブコマンドはリモートモードだけサポートします。

前提条件

ドメイン管理サーバは、稼働状態である必要があります。

引数

--help | -?

このサブコマンドのヘルプテキストを表示します。

--target target

作成するシステムプロパティーの対象を指定します。

型：String

指定できる値を次に示します。

• server

  ドメイン管理サーバを対象とします。serverはドメイン管理サーバの名称です。

• domain

  ドメインを対象とします。

• configuration_name

  指定した名称の構成を対象とします。

• cluster_name

  指定した名称のクラスターを対象とします。

• instance_name

  指定した名称のサーバインスタンスを対象とします。

デフォルト値：server

name=value[:name=value]...

指定した対象に追加するシステムプロパティーのプロパティー名と値のペアを指定します。

複数システムプロパティー記述する場合コロン（:）で区切る必要があります。コロン（:）がシステムプロパティーの名前や値に含まれる場合、円記号（\）でエスケープする必要があります。

型：String

指定できる値を次に示します。

• システムプロパティーのプロパティー名と値のペア

デフォルト値：なし

asadmin create-system-properties --target myserver http-listener-port=1088

戻り値

戻り値	説明
0	サブコマンドの実行に成功しました。
1	サブコマンドの実行中にエラーが発生しました。

注意事項

このコマンドのオプションに次のシステムプロパティーを指定しないでください。Message Queueのログの設定（config.properties）に影響を与えます。

• java.util.logging.FileHandler.count

• java.util.logging.FileHandler.limit

• java.util.logging.FileHandler.level

• java.util.logging.FileHandler.pattern