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.

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

Gibt eine Liste der Eigenschaften zurück, die den Ressourcennamen beinhalten und anzeigen, ob die Richtlinienkonfiguration der Ressource gemeinsam genutzt werden kann. Die folgenden Eigenschaften können zurückgegeben werden:
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]] ]

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_getppolicysi
Dateiname:rwbs_wsp_getppolicysi.html