Share via

3.1.4.1.13 wsen:Filter

  • Article

The WS-Management specification defines the Filter element, which is used to retrieve a subset of the result set, as specified in [DMTF-DSP0226] section 8.2.1.

The WMI specification defines the WQL query language, as specified in [MS-WMI] section 2.2.1.

The Web Services Management Protocol Extensions for Windows Vista service MUST process the request if it is targeted to a ResourceURI for a CIM or WMI resource and contains the Filter element with a Dialect identifying WQL: http://schemas.microsoft.com/wbem/wsman/1/WQL. The results of the WQL query MUST be rendered as described in the WS-Management CIM Binding specification for CQL, as specified in [DMTF-DSP0227] section 8.1.<58><59>

The WS-Management CIM Binding specification defines the Association Queries language, as specified in [DMTF-DSP0227] section 8.2.

The Web Services Management Protocol Extensions for Windows Vista service MUST process the request if it is targeted to a ResourceURI for a CIM resource and contains the Filter element with a Dialect identifying Association Query: http://schemas.dmtf.org/wbem/wsman/1/cimbinding/associationFilter. The results of the Association Query MUST be rendered as described in the WS-Management CIM Binding specification for Association Query, as specified in [DMTF-DSP0227] section 8.2.

The WS-Management CIM Binding specification (as specified in [DMTF-DSP0227]) defines the wsmb:Expression element to correlate response elements with portions of the select-clause.<60>

The Web Services Management Protocol Extensions for Windows Vista service MUST return a wsen:FilteringNotSupported fault if the enumerate request contains the Filter element for any ResourceURI that is not for a CIM or WMI resource.

The WS-Management specification defines wsman:Filter as an alternative mechanism to specify filters that are different from that of the wsen:Filter, as specified in [DMTF-DSP0226] section 8.3.

The Web Services Management Protocol Extensions for Windows Vista service MUST support the wsen:Filter element, and MUST support filter expressions in the XPath Level 1 dialect as specified in [DMTF-DSP0226] Annex D.1.

The Web Services Management Protocol Extensions for Windows Vista service MUST support the wsman:Filter element and process it exactly the same as if the wsen:Filter element were present.

The Web Services Management Protocol Extensions for Windows Vista supports the Selector filter dialect, as specified in [DMTF-DSP0226] Annex E, which is a simple filtering dialect that allows a filtered enumeration with no representation change. Selectors are part of the default addressing model as specified in [DMTF-DSP0226] section 5.1.2.2.<61>

When using the Selector filter dialect, the value of the dialect attribute MUST be http://schemas.dmtf.org/wbem/wsman/1/wsman/SelectorFilter. The following rules apply to the processing of Selector filters:

  • Selector Filter Dialect can only be used for class-specific resource URIs, as specified in [DMTF-DSP0227] section 6.1.

  • The filter expression MUST be rejected and the server SHOULD reply with an error response in the following cases:

    • The selector set contains duplicate selector names.

    • The selector names a property of one of the following types:

      • Array

      • Datetime

      • Reference or object

    • The value contains either the double quotation mark (") character or the single quotation mark (') character.

If the filter expression does not conform, the Web Services Management Protocol Extensions for Windows Vista server SHOULD return a wsen:CannotProcessFilter fault.