Befehl "getClientDynamicPolicyControl"

Verwenden Sie den Befehl getClientDynamicPolicyControl, um festzustellen, ob eine Anwendung, die ein Web-Service-Client ist, die Richtlinienkonfiguration eines Web-Service-Providers abruft, und um die Eigenschaften für das Abrufen dieser Konfiguration aufzulisten.

Verwenden Sie für die Ausführung des Befehls das Objekt "AdminTask" des wsadmin-Scripting-Clients.

[IBM i]Der wsadmin-Scripting-Client wird über die Qshell ausgeführt. Weitere Informationen finden Sie im Artikel "Qshell für die Ausführung von WebSphere Application Server-Scripts konfigurieren".

Dieser Befehl ist nur gültig, wenn er mit Anwendungsservern der WebSphere Application Server Version 7 und höher verwendet wird. Verwenden Sie diesen Befehl nicht in früheren Versionen.

Sie können eine Liste der verfügbaren Verwaltungsbefehle für die Richtliniensatzverwaltung sowie eine Kurzbeschreibung jedes einzelnen Befehls abrufen, indem Sie an der wsadmin-Eingabeaufforderung den folgenden Befehl eingeben:

print AdminTask.help('PolicySetManagement')

Zum Anzeigen einer übersichtlichen Hilfe zu einem bestimmten Befehl geben Sie an der wsadmin-Eingabeaufforderung den folgenden Befehl ein:

print AdminTask.help('Befehlsname')

Speichern Sie Ihre Änderungen nach der Verwendung des Befehls in der Masterkonfiguration. Verwenden Sie beispielsweise den folgenden Befehl:

AdminConfig.save()

Zweck

Verwenden Sie den Befehl getClientDynamicPolicyControl, um festzustellen, wie eine Anwendung oder ein Service in einer Anwendung die Richtlinienkonfiguration eines Web-Service-Providers abruft. Der Client kann die Richtlinienkonfiguration des Providers über eine HTTP-GET-Anforderung oder eine WS-MetadataExchange-Anforderung (Web Services Metadata Exchange) abrufen.

Zielobjekt

Ohne.

Erforderliche Parameter

-applicationName
Der Name der Anwendung, für die Sie feststellen möchten, wie sie die Richtlinienkonfiguration eines Service-Providers abruft. Die Anwendung muss ein Service-Client sein. (String)

Optionale Parameter

-resource
Der Name der Ressource, für die Sie feststellen möchten, wie sie die Richtlinienkonfiguration eines Service-Providers abruft. Wenn Sie diesen Parameter angeben, werden nur die Eigenschaften für diese Ressource zurückgegeben. Geben Sie zum Abrufen der Informationen für die Anwendung WebService:/ an. Alternativ können Sie einen Service, eine Servicereferenz, einen Endpunkt oder eine Operation angeben. (String)
Weitere Informationen finden Sie unter "Clientrichtlinie auf der Basis einer Service-Provider-Richtlinie mit wsadmin-Scripting konfigurieren".

Rückgabewert

Gibt eine Liste der Eigenschaften zurück, die den Ressourcennamen beinhalten und anzeigen, wie die Ressource die Richtlinienkonfiguration eines Service-Providers abruft. Die folgenden Eigenschaften können zurückgegeben werden:
httpGetTargetURI
Der Ziel-URL der HTTP-GET-Anforderung. Diese Eigenschaft wird zurückgegeben, wenn die Eigenschaft acquireProviderPolicyMethod den Wert httpGet hat.
httpGetPolicySetName
Der Systemrichtliniensatz, der die HTTP- und SSL-Transportrichtlinie für die HTTP-GET-Anforderung enthält. Diese Eigenschaft wird zurückgegeben, wenn die Eigenschaft httpGetTargetURI einen Wert hat.
httpGetPolicySetBinding
Die allgemeine Bindung, die die HTTP- und SSL-Transportbindungen für die HTTP-GET-Anforderung enthält. Diese Eigenschaft wird zurückgegeben, wenn die Eigenschaft httpGetTargetURI einen Wert hat.
wsMexPolicySetName
Der Name des Richtliniensatzes, der die Sicherheit auf Nachrichtenebene angibt, wenn die Ressource ihre Richtlinienkonfiguration über eine WS-MetadataExchange-Anforderung zur gemeinsamen Nutzung freigibt. Diese Eigenschaft wird zurückgegeben, wenn die Eigenschaft acquireProviderPolicyMethod den Wert wsMex hat und ein Richtliniensatz zur Bereitstellung der Sicherheit auf Nachrichtenebene angegeben wurde.
wsMexPolicySetBinding
Der Name der Bindung, die verwendet wird, wenn die Ressource ihre Richtlinienkonfiguration über eine WS-MetadataExchange-Anforderung zur gemeinsamen Nutzung freigibt. Diese Eigenschaft wird zurückgegeben, wenn die Eigenschaft acquireProviderPolicyMethod den Wert wsMex hat und eine Bindung zur Bereitstellung der Sicherheit auf Nachrichtenebene angegeben wurde.
acquireProviderPolicyMethod
Gibt an, wie die Richtlinienkonfiguration des Providers abgerufen werden kann. Die gültigen Werte für diese Eigenschaft sind im Folgenden aufgelistet:
wsMex
Die Ressource kann die Richtlinienkonfiguration eines Service-Providers über eine WS-MetadataExchange-Anforderung abrufen.
httpGet
Die Ressource kann die Richtlinienkonfiguration eines Service-Providers über eine HTTP-GET-Anforderung abrufen.
Ressource
Die Ressource, die Sie angegeben haben.
directSetting
Gibt an, wie die Eigenschaften auf die Ressource angewendet werden sollen. Gültige Werte für diese Eigenschaft:
true
Die Eigenschaften werden direkt auf die Ressource angewendet.
false
Die Eigenschaften werden von der übergeordneten Anwendung oder vom übergeordneten Service übernommen.

Beispiele

Im folgenden Beispiel werden die Eigenschaften angezeigt, die festlegen, wie der Service EchoService der Anwendung WSPolicyClient die Richtlinienkonfiguration eines Service-Providers abruft. Der Client ist konfiguriert, die Providerrichtlinie über eine WS-MetadataExchange-Anforderung mit Sicherheit auf Nachrichtenebene mit dem Richtliniensatz SystemWSSecurityDefault und der allgemeinen Bindung "Client sample" abzurufen.

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

Im folgenden Beispiel werden die Eigenschaften angezeigt, die festlegen, wie der Service EchoService der Anwendung WSPolicyClient die Richtlinienkonfiguration eines Service-Providers abruft. Der Client ist konfiguriert, die Providerrichtlinie über eine HTTP-GET-Anforderung abzurufen.

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

Symbol, das den Typ des Artikels anzeigt. Referenzartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rwbs_wsp_getcdpolicyc
Dateiname:rwbs_wsp_getcdpolicyc.html