getClientDynamicPolicyControl コマンド

getClientDynamicPolicyControl コマンドを使用して、Web サービス・クライアントであるアプリケーションが Web サービス・プロバイダーのポリシー構成を取得しているかどうかを調べ、その構成の取得に適用されるプロパティーをリストします。

コマンドを実行するには、wsadmin スクリプト・クライアントの AdminTask オブジェクトを使用します。

[IBM i]wsadmin スクリプト・クライアントは、Qshell から実行されます。 詳しくは、『WebSphere® Application Server スクリプトを実行するための Qshell の構成』のトピックを参照してください。

このコマンドは、WebSphere Application Server バージョン 7 以降のアプリケーション・サーバーで使用した場合にのみ有効です。 これより前のバージョンでは使用しないでください。

使用可能なポリシー・セット管理コマンドと、各コマンドの概要については、 wsadmin プロンプトで次のコマンドを入力してください。

print AdminTask.help('PolicySetManagement')

特定のコマンドの概要ヘルプの場合は、wsadmin プロンプトで以下のコマンドを入力します。

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] ]

トピックのタイプを示すアイコン 参照トピック



タイム・スタンプ・アイコン 最終更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rwbs_wsp_getcdpolicyc
ファイル名:rwbs_wsp_getcdpolicyc.html