GlobalDiagnosticPackage Complex Type

  • Article

Defines the manifest as a global troubleshooting pack.

<xs:complexType name="GlobalDiagnosticPackage">
    <xs:sequence>
        <xs:element name="DiagnosticIdentification"
            type="dcmPS:DiagnosticIdentification"
            minOccurs="1"
            maxOccurs="1"
         />
        <xs:element name="DisplayInformation"
            type="dcmPS:DisplayInformation"
            minOccurs="1"
            maxOccurs="1"
         />
        <xs:element name="PrivacyLink"
            type="dcmPS:Link"
            minOccurs="1"
            maxOccurs="1"
         />
        <xs:element name="PowerShellVersion"
            type="dcmPS:Version"
            minOccurs="1"
            maxOccurs="1"
         />
        <xs:element name="SupportedOSVersion"
            type="dcmPS:SupportedOSVersion"
            minOccurs="1"
            maxOccurs="1"
         />
        <xs:element name="Troubleshooter"
            type="dcmPS:Troubleshooter"
            minOccurs="1"
            maxOccurs="1"
         />
        <xs:element name="Rootcauses"
            type="dcmPS:GlobalRootcauses"
            minOccurs="1"
            maxOccurs="1"
        >
            <xs:unique name="No_global_rootcause_may_have_the_same_ID">
                <xs:selector
                    xpath="Rootcause"
                 />
                <xs:field
                    xpath="ID"
                 />
            </xs:unique>
        </xs:element>
        <xs:element name="Interactions"
            type="dcmPS:Interactions"
            minOccurs="1"
            maxOccurs="1"
         />
        <xs:element name="ExtensionPoint"
            type="dcmPS:ExtensionPoint"
            minOccurs="1"
            maxOccurs="1"
         />
    </xs:sequence>
    <xs:attribute name="SchemaVersion"
        type="dcmPS:Version"
        use="required"
     />
    <xs:attribute name="Localized"
        type="xs:boolean"
        use="required"
     />
</xs:complexType>

Child elements

Element Type Description
DiagnosticIdentification [dcmPS:DiagnosticIdentification](package-diagnosticidentification-complextype.md) The identifier and version used to identify the pack.
DisplayInformation [dcmPS:DisplayInformation](package-displayinformation-complextype.md) The name and description of the pack.
ExtensionPoint [dcmPS:ExtensionPoint](package-extensionpoint-complextype.md) One or more extensions that the client supports. Used by the client to extend the functionality of the [DiagnosticPackage](package-diagnosticpackage-element.md) node. The MSDT client supports the following extensions:
Extension Description
HelpKeywords Specifies a single keyword. The extension contains the localized resource identifier for the keyword (for example, "@resource.dll,-123"). To specify multiple keywords, include a HelpKeywords element for each keyword.
The keywords are used only if the package fails. If the package fails and the user clicks Explore additional options, the keywords are used to find related information if the user then clicks Help and Support, Windows Communities, or Related Troubleshooters.
For Help and Support, the keywords are used in a logical OR operation and for Windows Communities and Related Troubleshooters, the keywords are used in a logical AND operation.
These keywords are used only if the root cause that failed does not specify keywords (see the ContextParameters child element of the [GlobalRootcause](package-globalrootcause-complextype.md) complex type).
Icon An icon to display next to the package. The Icon element contains the resource identifier for the icon (for example, "@resource.dll,-123").

Interactions [dcmPS:Interactions](package-interactions-complextype.md)

The interactions that the pack uses.
PowerShellVersion [dcmPS:Version](package-version-simpletype.md)

The minimum Windows PowerShell version required to run the pack.
PrivacyLink [dcmPS:Link](package-link-simpletype.md)

The URL to the privacy information that tells the user how the data collected by your troubleshooting pack will be used.
Rootcauses [dcmPS:GlobalRootcauses](package-globalrootcauses-complextype.md)

The collection root causes to detect, resolve, and verify.
SupportedOSVersion [dcmPS:SupportedOSVersion](package-supportedosversion-complextype.md)

The minimum operating system version on which the pack can run.
Troubleshooter [dcmPS:Troubleshooter](package-troubleshooter-complextype.md)

The troubleshooting script to run.

Attributes

Name Type Description
Localized xs:boolean Determines whether the strings specified in the manifest are resource strings (true) or literals (false). If true, all UI elements in the manifest must specify a resource identifier (for example, @resource.dll,-123). For localization details, see Localizing the Troubleshooting Pack.
SchemaVersion dcmPS:Version The version of the troubleshooting pack schema used to write this manifest. For Windows 7, the version is 1.0.

Remarks

A manifest that contains this node contains a single troubleshooter that can detect multiple root causes. The troubleshooter script determines the order in which the root causes are detected the script's logic can detect all the root causes or skip individual root causes (for example, the script might skip RootCauseB if RootCauseB depends on first detecting RootCauseA).

Requirements
Minimum supported client
 Windows 7 [desktop apps only]
Minimum supported server
 Windows Server 2008 R2 [desktop apps only]

See also

DiagnosticPackage Element