getClientDynamicPolicyControl コマンド
getClientDynamicPolicyControl コマンドを使用して、Web サービス・クライアントであるアプリケーションが Web サービス・プロバイダーのポリシー構成を取得しているかどうかを調べ、その構成の取得に適用されるプロパティーをリストします。
コマンドを実行するには、wsadmin スクリプト・クライアントの AdminTask オブジェクトを使用します。
wsadmin スクリプト・クライアントは、Qshell から実行されます。
詳しくは、『WebSphere® Application
Server スクリプトを実行するための Qshell の構成』のトピックを参照してください。
このコマンドは、WebSphere Application Server バージョン 7 以降のアプリケーション・サーバーで使用した場合にのみ有効です。 これより前のバージョンでは使用しないでください。
print AdminTask.help('PolicySetManagement')
print AdminTask.help('command_name')
AdminConfig.save()
目的
getClientDynamicPolicyControl コマンドは、アプリケーション、つまりアプリケーション内のサービスがサービス・プロバイダーのポリシー構成をどのように取得するかを調べる場合に使用します。クライアントは、Web サービス・メタデータ交換 (WS-MetadataExchange) 要求または HTTP GET 要求により、プロバイダーのポリシー構成を取得できます。
ターゲット・オブジェクト
なし。
必須パラメーター
- -applicationName
- サービス・プロバイダーのポリシー構成をどのように取得するかを調べる対象アプリケーションの名前。このアプリケーションは、サービス・クライアントであることが必要です。 (ストリング)
オプション・パラメーター
- -resource
- サービス・プロバイダーのポリシー構成をどのように取得するかを調べる対象リソースの名前。このパラメーターを指定すると、そのリソースのプロパティーのみが返されます。 アプリケーションの情報を取得するには、WebService:/ を指定します。 あるいは、サービス、 サービス参照、 エンドポイント、または操作を指定できます。 (ストリング)
- 詳しくは、トピック『サービス・プロバイダー・ポリシーを使用するクライアント・ポリシーの wsadmin スクリプトを使用した構成』を参照してください。
戻り値
- httpGetTargetURI
- HTTP GET 要求のターゲット URL です。このプロパティーは、acquireProviderPolicyMethod プロパティーの値が httpGet である場合に返されます。
- httpGetPolicySetName
- HTTP GET 要求に使用する HTTP と SSL のトランスポート・ポリシーを含むシステム・ポリシー・セット。このプロパティーは、httpGetTargetURI プロパティーに値がある場合に戻されます。
- httpGetPolicySetBinding
- HTTP GET 要求に使用する HTTP と SSL のトランスポート・バインディングを含む汎用バインディング。このプロパティーは、httpGetTargetURI プロパティーに値がある場合に戻されます。
- wsMexPolicySetName
- リソースが WS-MetadataExchange 要求を介してポリシー構成を共有する場合の、メッセージ・レベル・セキュリティーを指定するポリシー・セットの名前です。このプロパティーは、acquireProviderPolicyMethod プロパティーの値が wsMex であり、メッセージ・レベルのセキュリティーを提供するポリシー・セットが指定されていた場合に返されます。
- wsMexPolicySetBinding
- リソースが WS-MetadataExchange 要求を使用してポリシー構成を共有する場合に使用されるバインディングの名前。このプロパティーは、acquireProviderPolicyMethod プロパティーの値が wsMex であり、メッセージ・レベルのセキュリティーを提供するバインディングが指定されていた場合に返されます。
- acquireProviderPolicyMethod
- プロバイダーのポリシー構成を取得する方法。このプロパティーの有効な値は、以下のとおりです。
- wsMex
- リソースは、WS-MetadataExchange 要求を使用して、サービス・プロバイダーのポリシー構成を取得できます。
- httpGet
- リソースは HTTP GET 要求によってサービス・プロバイダーのポリシー構成を取得できます。
- リソース (resource)
- 指定したリソースです。
- directSetting
- リソースへのプロパティーの適用方法です。このプロパティーの有効な値は、以下のとおりです。
- true
- プロパティーは、リソースに直接適用されます。
- false
- プロパティーは、親のアプリケーションまたはサービスから継承されます。
例
以下の例は、WSPolicyClient アプリケーションの EchoService サービスが、サービス・プロバイダーのポリシー構成を取得する方法を制御するプロパティーを表示します。クライアントは、SystemWSSecurityDefault ポリシー・セットと"クライアントのサンプル"一般バインディングを使用して、メッセージ・レベル・セキュリティーを持つ WS-MetadataExchange 要求によってプロバイダー・ポリシーを取得するように構成されています。
AdminTask.getClientDynamicPolicyControl(['-applicationName', 'WSPolicyClient',
'-resource', 'WebService:/WSPClient.war:{http://example_path/}EchoService'])
.
.
[ [wsMexPolicySetName SystemWSSecurityDefault] [wsMexPolicySetBinding [Client sample]]
[acquireProviderPolicyMethod [wsMex]]
[resource WebService:/WSPClient.war:{http://example_path/}EchoService/]
[directSetting true] ]
以下の例は、クライアントが HTTP GET 要求を使用してプロバイダー・ポリシーを取得するように構成されている場合に、WSPolicyClient アプリケーションの EchoService サービスでサービス・プロバイダーのポリシー構成を取得する方法を制御するプロパティーを示しています。
AdminTask.getClientDynamicPolicyControl(['-applicationName', 'WSPolicyClient',
'-resource', 'WebService:/WSPClient.war:{http://example_path/}EchoService'])
.
.
[ [httpGetTargetURI http://example_path/EchoService?wsdl]
[acquireProviderPolicyMethod [httpGet]]
[resource WebService:/WSPClient.war:{http://example_path/}EchoService/]
[directSetting true] ]