getProviderPolicySharingInfo command
Use the getProviderPolicySharingInfo command to find out whether an application or service that is a web service provider can share its policy configuration, and list the properties that apply to sharing that configuration.
如果要執行這個指令,請使用 wsadmin Scripting 用戶端的 AdminTask 物件。
wsadmin Scripting 用戶端是從 Qshell 執行的。
如需相關資訊,請參閱「配置 Qshell 執行 WebSphere® Application Server Script」主題。
只有在搭配 WebSphere Application Server 第 7 版及版本更新的應用程式伺服器時,這個指令才有效。請勿搭配較舊的版本來使用它。
print AdminTask.help('PolicySetManagement')
print AdminTask.help('command_name')
AdminConfig.save()
Purpose
Use the getProviderPolicySharingInfo command to find out how a web services application, or a service in a Web services application, shares its policy configuration with clients, service registries, or services that support the WS-Policy specification. The policy configuration is shared in WS-PolicyAttachments format.
The command returns properties that show whether the policy configuration of the resource can be shared with clients through a WS-MetadataExchange request or through Web Services Description Language (WSDL) that is obtained by a ?WSDL HTTP Get request.
Target object
None.
Required parameters
- -applicationName
- The name of the application for which you want to find out how it shares its policy configuration. The application must be a service provider. (String)
Optional parameters
- -resource
- The name of the resource for which you want to find out how it shares its policy configuration. If you specify this parameter, only the properties for that resource are returned. To retrieve information for the application, specify WebService:/. Alternatively, you can specify a service, endpoint or operation. However, policy sets are attached only at the application or service level, so the properties returned for an endpoint or operation are the settings that are inherited from the service. (String)
Return value
- wsMexPolicySetName
- The name of the policy set that specifies message-level security when the resource shares its policy configuration through a WS-MetadataExchange request. This property is returned if the value of the sharePolicyMethods property is wsMex and a policy set to provide message-level security was specified.
- wsMexPolicySetBinding
- The name of the binding that is applied when the resource shares its policy configuration through a WS-MetadataExchange request. This property is returned if the value of the sharePolicyMethods property is wsMex and a binding to provide message-level security was specified.
- resource
- The resource that you specified.
- directSetting
- How the properties apply to the resource. Valid values for this
property are:
- true
- The properties apply directly to the resource.
- false
- The properties are inherited from the parent application or service.
- sharePolicyMethods
- How the policy configuration of the resource can be shared. Valid
values for this property are:
- httpGet
- The resource shares its policy configuration through an HTTP Get request.
- wsMex
- The resource shares its policy configuration through a WS-MetadataExchange request.
Example
The following command displays the policy sharing configuration properties for the EchoService service in the WSSampleServices application. The provider is configured to share its policy through an HTTP Get request, and a WS-MetadataExchange request with message-level security. Message-level security for the WS-MetadataExchange request is provided by using the SystemWSSecurityDefault policy set and the "Provider sample" general binding.
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]] ]