Befehl "getProviderPolicySharingInfo"
Verwenden Sie den Befehl getProviderPolicySharingInfo, um festzustellen, ob eine Anwendung oder ein Service, die bzw. der ein Web-Service-Provider ist, ihre bzw. seine Richtlinienkonfiguration zur gemeinsamen Nutzung freigeben kann, und um die Eigenschaften für die gemeinsame Nutzung 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 getProviderPolicySharingInfo, um festzustellen, wie eine Web-Service-Anwendung oder ein Service in einer Web-Service-Anwendung ihre bzw. seine Richtlinienkonfiguration mit anderen Clients, Service-Registrys oder Services, die die WS-Policy-Spezifikation unterstützen, gemeinsam nutzt. Die Richtlinienkonfiguration wird im WS-PolicyAttachments-Format zur gemeinsamen Nutzung freigegeben.
Der Befehl gibt Eigenschaften zurück, die zeigen, ob die Richtlinienkonfiguration der Ressource über eine WS-MetadataExchange-Anforderung oder eine WSDL-Datei (Web Services Description Language), die mit einer ?WSDL-HTTP-Get-Anforderung abgerufen wird, gemeinsam mit Clients genutzt werden kann.
Zielobjekt
Ohne.
Erforderliche Parameter
- -applicationName
- Der Name der Anwendung, für die Sie feststellen möchten, wie sie die Richtlinienkonfiguration zur gemeinsamen Nutzung freigibt. Die Anwendung muss ein Service-Provider sein. (String)
Optionale Parameter
- -resource
- Der Name der Ressource, für die Sie feststellen möchten, wie sie die Richtlinienkonfiguration zur gemeinsamen Nutzung freigibt. 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 dazu können Sie einen Service, einen Endpunkt oder eine Operation angeben. Richtliniensätze werden jedoch nur auf Anwendungs- oder Serviceebene zugeordnet, d. h., die Eigenschaften, die für einen Endpunkt oder eine Operation zurückgegeben werden, sind die Einstellungen, die vom Service übernommen werden. (String)
Rückgabewert
- 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 sharePolicyMethods den Wert wsMex hat und ein Richtliniensatz zur Bereitstellung der Sicherheit auf Nachrichtenebene angegeben wurde.
- wsMexPolicySetBinding
- Der Name der Bindung, die angewendet wird, wenn die Ressource ihre Richtlinienkonfiguration über eine WS-MetadataExchange-Anforderung zur gemeinsamen Nutzung freigibt. Diese Eigenschaft wird zurückgegeben, wenn die Eigenschaft sharePolicyMethods den Wert wsMex hat und eine Bindung zur Bereitstellung der Sicherheit auf Nachrichtenebene angegeben wurde.
- 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.
- sharePolicyMethods
- Gibt an, wie die Richtlinienkonfiguration der Ressource gemeinsam genutzt werden kann. Folgende Werte sind für diese Eigenschaft gültig:
- httpGet
- Die Ressource gibt ihre Richtlinienkonfiguration über eine HTTP-Get-Anforderung zur gemeinsamen Nutzung frei.
- wsMex
- Die Ressource gibt ihre Richtlinienkonfiguration über eine WS-MetadataExchange-Anforderung zur gemeinsamen Nutzung frei.
Beispiel
Der folgende Befehl zeigt die Eigenschaften für die gemeinsame Nutzung der Richtlinienkonfiguration für den Service EchoService in der Anwendung WSSampleServices an. Der Provider wird konfiguriert, seine Richtlinie über eine HTTP-Get-Anforderung und eine WS-MetadataExchange-Anforderung mit Sicherheit auf Nachrichtenebene zur gemeinsamen Nutzung freizugeben. Die Sicherheit auf Nachrichtenebene für die WS-MetadataExchange-Anforderung wird mit dem Richtliniensatz SystemWSSecurityDefault und der allgemeinen Bindung "Provider sample" bereitgestellt.
AdminTask.getProviderPolicySharingInfo(['-applicationName', 'WSSampleServices',
'-resource', 'WebService:/SampleServicesSei.war:{http://example_path/}EchoService'])
.
.
[ [wsMexPolicySetName SystemWSSecurityDefault] [wsMexPolicySetBinding [Provider sample]]
[resource WebService:/SampleServicesSei.war:{http://example_path/}EchoService/]
[directSetting true] [sharePolicyMethods [httpGet wsMex]] ]