2.2.4.13 CustomRemoteShell

  • Article

CustomRemoteShellType contains configuration data that's used to create a custom Shell. Web Services Management Protocol Extensions for Windows Vista clients MAY use this configuration to create a custom Shell instead of cmd.exe. Web Services Management Protocol Extensions for Windows Vista service SHOULD <12> use this configuration to create a custom Shell when it receives a Create request (as defined in section 3.1.4.5) and the request contains a resource URI that is specified in the CustomRemoteShell configuration.

The type is used under the following namespace: http://schemas.microsoft.com/wbem/wsman/1/config/winrs/customremoteshell

The schema for CustomRemoteShellType MUST be as follows.

 <xs:complexType name="CustomRemoteShell">
   <xs:sequence>
     <xs:element name="URI"
       type="xs:anyURI"
       minOccurs="0"
       maxOccurs="1"
      />
     <xs:element name="Shell"
       type="xs:string"
       minOccurs="1"
       maxOccurs="1"
      />
     <xs:element name="Arguments"
       type="xs:string"
       minOccurs="0"
       maxOccurs="1"
      />
   </xs:sequence>
 </xs:complexType>
 

Elements

URI: This optional attribute refers to the resource URI for the custom Shell.

Shell: This attribute contains the process string for the custom Shell. It can contain environment variables.

Arguments: This optional attribute contains the argument string and it specifies the command line arguments to be passed to the custom Shell. The Arguments field is treated as an opaque value; it is up to the Shell itself to interpret these arguments.