Befehl "setProviderPolicySharingInfo"

Verwenden Sie den Befehl setProviderPolicySharingInfo, um festzulegen, wie eine Anwendung oder ein Service, der ein Web-Service-Provider ist, ihre bzw. seine Richtlinienkonfiguration mit anderen Clients, Service-Registrys oder Services, die die WS-Policy-Spezifikation unterstützen, gemeinsam nutzen kann. Sie können diese Informationen, die festlegen, wie eine Providerrichtlinie gemeinsam genutzt werden soll, definieren oder löschen.

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 setProviderPolicySharingInfo, um festzulegen, wie eine Anwendung oder ein Service in einer Anwendung, ihre bzw. seine Richtlinienkonfiguration mit Clients, Service-Registrys oder Services, die die WS-Policy-Spezifikation unterstützen, gemeinsam nutzen kann. Die Richtlinienkonfiguration wird im WS-PolicyAttachments-Format zur gemeinsamen Nutzung freigegeben.

Die Richtlinienkonfiguration der Ressource kann mit Clients über eine WS-MetadataExchange-Anforderung oder eine WSDL-Datei (Web Services Description Language), die über eine ?WSDLHTTP-Get-Anforderung abgerufen wird, gemeinsam genutzt werden.

Zielobjekt

Ohne.

Erforderliche Parameter

-applicationName
Der Name der Anwendung, für die Sie festlegen möchten, wie sie die Richtlinienkonfiguration zur gemeinsamen Nutzung freigeben soll. (String)
-resource
Der Name der Ressource, für die Sie festlegen möchten, wie die Richtlinienkonfiguration gemeinsam genutzt werden soll. Geben Sie zum Abrufen aller Ressourcen in einer Anwendung WebService:/ an. Geben Sie für einen Service in einer Anwendung WebService:/Modul:{Namespace}Servicename an. Endpunkte oder Operationen übernehmen die Einstellungen der übergeordneten Anwendung bzw. des übergeordneten Service. (String)

Optionale Parameter

-sharePolicyMethods
Gibt an, wie die Richtlinienkonfiguration der Ressource gemeinsam genutzt werden kann. (String array)
Setzen Sie einen oder beide der folgenden Befehle ab:
httpGet
Die Ressource kann ihre Richtlinienkonfiguration über eine WSDL-Datei, die mit einer ?WSDL-HTTP-Get-Anforderung abgerufen wird, zur gemeinsamen Nutzung freigeben.
wsMex
Die Ressource kann ihre Richtlinienkonfiguration über eine WS-MetadataExchange-Anforderung zur gemeinsamen Nutzung freigeben.
-wsMexProperties
Gibt an, dass die Sicherheit auf Nachrichtenebene für WS-MetadataExchange-Anforderungen erforderlich ist, und gibt außerdem die Einstellungen an, die die Sicherheit auf Nachrichtenebene bereitstellen. (Eigenschaften)
Geben Sie die folgenden Werte und die gewünschten Einstellungen für die Werte ein:
wsMexPolicySetName
Der Name des Systemrichtliniensatzes, der die Sicherheit auf Nachrichtenebene angibt, wenn die Ressource ihre Richtlinienkonfiguration über eine WS-MetadataExchange-Anforderung zur gemeinsamen Nutzung freigibt. Geben Sie einen Systemrichtliniensatz an, der nur WS-Security-Richtlinien und/oder nur WS-Addressing-Richtlinien enthält. Der Standardrichtliniensatz ist SystemWSSecurityDefault.
wsMexPolicySetBinding
Der Name der allgemeinen Bindung für die Richtliniensatzzuordnung, die verwendet wird, wenn die Ressource ihre Richtlinienkonfiguration über eine WS-MetadataExchange-Anforderung zur gemeinsamen Nutzung freigibt. Sie können aus allgemeinen Bindungen für die globale Domäne oder die Sicherheitsdomäne dieses Service auswählen. Wenn Sie diese Eigenschaft nicht angeben, wird die Standardbindung verwendet.

Dieser Parameter ist nur gültig, wenn Sie für den Parameter sharePolicyMethods den Wert wsMex angeben.

-remove
Gibt an, ob die Informationen, die festlegen, wie die Providerrichtlinie gemeinsam genutzt werden soll, aus der Ressource gelöscht werden soll. (Boolean)
Folgende Werte sind für diesen Parameter gültig:
true
Die Informationen, die festlegen, wie die Providerrichtlinie gemeinsam genutzt werden soll, wird aus der Ressource gelöscht.
false
Dieser Wert ist der Standardwert. Die Informationen, die festlegen, wie die Providerrichtlinie gemeinsam genutzt werden soll, wird nicht aus der Ressource gelöscht.

Beispiele

Im folgenden Beispiel werden die Informationen, die festlegen, wie die Providerrichtlinie gemeinsam genutzt werden soll, aus der Anwendung WSSampleServices gelöscht.

AdminTask.setProviderPolicySharingInfo('[-applicationName WSSampleServices 
-resource WebService:/ -remove true]')

Im folgenden Beispiel wird die gemeinsame Nutzung der Richtlinie unter Verwendung einer WSDL aktiviert, die mit einer ?WSDL-HTTP-Get-Anforderung für den Service "EchoService" in der Anwendung "WSSampleServices" exportiert wird:

AdminTask.setProviderPolicySharingInfo('[-applicationName WSSampleServices 
-resource WebService:/WSSampleServicesSei.war:{http://example_path/}EchoService 
-sharePolicyMethods [httpGet ]]') 

Im folgenden Beispiel wird die gemeinsame Nutzung der Richtlinie über eine WS-MetadataExchange-Anforderung mit Sicherheit auf Nachrichtenebene für die Anwendung WSSampleServices aktiviert. Die Sicherheit auf Nachrichtenebene wird mit dem Richtliniensatz SystemWSSecurityDefault und der allgemeinen Bindung "Provider sample" bereitgestellt.

AdminTask.setProviderPolicySharingInfo('[-applicationName WSSampleServices 
-resource WebService:/ -sharePolicyMethods [wsMex ] 
-wsMexProperties [ [wsMexPolicySetName [SystemWSSecurityDefault]] 
[wsMexPolicySetBinding [Provider sample]] ]]')

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_setppolicysi
Dateiname:rwbs_wsp_setppolicysi.html