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.
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.
print AdminTask.help('PolicySetManagement')
print AdminTask.help('Befehlsname')
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
- 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] ]