Compartilhar via


3.1.4.2 Get

Web Services Management Protocol Extensions for Windows Vista MUST support the Get operation, using the following Action URIs, as specified in [DMTF-DSP0226].

 http://schemas.xmlsoap.org/ws/2004/09/transfer/Get
 http://schemas.xmlsoap.org/ws/2004/09/transfer/GetResponse
  

Web Services Management Protocol Extensions for Windows Vista includes no changes specific to the Get operation from the WS-Management Protocol, as specified in [DMTF-DSP0226], except as noted in section 3.1.4.1 and section 3.2.4.1.

The set of resource URIs on which Web Services Management Protocol Extensions for Windows Vista MUST support the Get operation is defined in the following table, and where relevant, the Xml Schema Definition (XSD) type for the data that is passed as part of the request or response is referenced.

Resource URI

Input data type

Output data type

http://schemas.microsoft.com/wbem/wsman/1/config

None

cfg:ConfigType

http://schemas.microsoft.com/wbem/wsman/1/config/client

None

cfg:ClientType

http://schemas.microsoft.com/wbem/wsman/1/config/client/auth

None

cfg:ClientAuthType

http://schemas.microsoft.com/wbem/wsman/1/config/client/defaultports

None

cfg:ClientDefaultPortsType

http://schemas.microsoft.com/wbem/wsman/1/config/service

None

cfg:ServiceType

http://schemas.microsoft.com/wbem/wsman/1/config/service/auth

None

cfg:ServiceAuthType

http://schemas.microsoft.com/wbem/wsman/1/config/service/defaultports

None

cfg:ServiceDefaultPortsType

http://schemas.microsoft.com/wbem/wsman/1/config/service/certmapping

None

cert:CertMappingType

http://schemas.microsoft.com/wbem/wsman/1/config/winrs

None

cfg:WinrsType

http://schemas.microsoft.com/wbem/wsman/1/config/listener

None

cfg:ListenerType

The set of resource URIs on which Web Services Management Protocol Extensions for Windows Vista SHOULD support the Get operation is defined in the following table, and where relevant, the Xml Schema Definition (XSD) type for the data that MUST be passed as part of the request or response is listed.

Resource URI

Input data type

Output data type

http://schemas.microsoft.com/wbem/wsman/1/config/plugin

None

cfg:PluginType

The set of resource URIs on which Web Services Management Protocol Extensions for Windows Vista MAY support the Get operation is defined in the following table, and where relevant, the Xml Schema Definition (XSD) type for the data that MUST be passed as part of the request or response is listed.

Resource URI

Input data type

Output data type

http://schemas.microsoft.com/wbem/wsman/1/windows/shell/cmd

None

rsp:Shell

The http://schemas.microsoft.com/wbem/wsman/1/config/service/security resource URI SHOULD be used to map an SDDL string to a particular resource URI. If this URI is used to map SDDL strings to particular resource URIs, the Web Services Management Protocol Extensions for Windows Vista servers MUST support the Get operation as defined in the following table, where the Xml Schema Definition (XSD) type for the data that is passed as part of the request or response is referenced.

Resource URI

Input data type

Output data type

http://schemas.microsoft.com/wbem/wsman/1/config/service/security

None

cfg:SecurityType

The resource URI http://schemas.microsoft.com/wbem/wsman/1/config/winrs/customremoteshell SHOULD<100>be used to manipulate CustomRemoteShells. By default, this table does not exist on the server, and the administrator MUST set this table up for the user to execute the custom remote Shell. If this URI is used to manipulate the CustomRemoteShells table, the Web Services Management Protocol Extensions for Windows Vista servers MUST support the Get operation as defined in the following table, where the Xml Schema Definition (XSD) type for the data that is passed as part of the request or response is referenced.

The data that is passed as part of the request is used when selecting a row from CustomRemoteShells (see section 3.1.1 for details). The Uri property is compared to the Uri element in order to identify the row to retrieve.

Resource URI

Input data type

Output data type

http://schemas.microsoft.com/wbem/wsman/1/config/winrs/customremoteshell

None

cfg:CustomRemoteShell

The CIM binding for WS-Management defines which operations can be used on which ResourceURIs when referencing CIM objects. More information is specified in [DMTF-DSP0227] section 7.

The Web Services Management Protocol Extensions for Windows Vista service MUST support WS-Transfer Get when the class name in the ResourceURI and the selectors identify an instance of that class.

The CIM binding for WS-Management defines the target ResourceURI that is used to retrieve class metadata in CIM-XML format, as specified in [DMTF-DSP0227-1.1.0] section 15.4. The Web Services Management Protocol Extensions for Windows Vista service SHOULD<101> support WS-Transfer Get when the ResourceURI is formatted to retrieve CIM-XML metadata as specified in [DMTF-DSP0227-1.1.0] section 15.4 and the ResourceURI identifies a valid class. If this metadata retrieval is implemented, the Web Services Management Protocol Extensions for Windows Vista service MUST support the following options as specified in [DMTF-DSP0227-1.1.0] section 15.8:

  • IncludeClassOrigin

  • IncludeQualifiers

  • IncludeInheritedElements