Edit

Merge-HwCertTestCollectionFromXml

  • Reference
Module:
HardwareCertification

Merges test result information from several test collection files into a single test collection.

Syntax

Merge-HwCertTestCollectionFromXml
     [-LiteralPath] <String[]>
     [-ValidationXmlPath <String>]
     [-HckBuildVersion <String>]
     [<CommonParameters>]

Description

The Merge-HwCertTestCollectionFromXml cmdlet merges test result information from several test collection .xml files into a single test collection. For more information, see Windows Hardware Certification Kit downloads in the Microsoft Developer Network (MSDN) Library.

You can use the Export-HwCertTestCollectionToXml cmdlet to export the merged test collection as an .xml file. You can use the New-HwCertTestCollectionExcelReport cmdlet to create a Microsoft Excel report of the test results.

Examples

Example 1: Merge two test collection files

PS C:\> Merge-HwCertTestCollectionFromXml -LiteralPath ("C:\Temp\BasicTest.xml", "C:\Temp\CertificationTest.xml")

This command merges the results in two test collection files. The command specifies files named BasicTest.xml and CertificationTest.xml.

Example 2: Merge two test collection files and export the result information

PS C:\> Merge-HwCertTestCollectionFromXml -LiteralPath ("C:\Temp\BasicTest.xml", "C:\Temp\CertificationTest.xml") | Export-HwCertTestCollectionToXml -Output "C:\Temp\Merged.xml"

This command merges the results in two test collection files and exports the test result information to an .xml file named Merged.xml. The command merges files named BasicTest.xml and CertificationTest.xml. The command then passes the merged results to the Export-HwCertTestCollectionToXml cmdlet by using the pipeline operator. That cmdlet exports the results.

Example 3: Merge several test collection files and export the result information

PS C:\> Get-ChildItem -Recurse "C:\Temp\*.xml" | Merge-HwCertTestCollectionFromXml | Export-HwCertTestCollectionToXml -Output "C:\Temp\Merged.xml"

This command merges the results in all the test collection files in a specified folder and exports the merged test result information to an .xml file named Merged.xml. The command uses the Get-ChildItem cmdlet to get all the .xml files in the C:\Temp folder. For more information, type Get-Help Get-ChildItem. The command then passes the .xml files to the Merge-HwCertTestCollectionFromXml cmdlet by using the pipeline operator. That cmdlet merges the test results. Finally, the command passes the merged results to the Export-HwCertTestCollectionToXml cmdlet. That cmdlet exports the results.

Parameters

-HckBuildVersion

Specifies an HCK build version. This cmdlet merges the results that match this build version only.

Type:String
Aliases:Build, Version
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LiteralPath

Specifies an array of file paths. These are file paths to test collection .xml files.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ValidationXmlPath

Specifies the path of a test collection .xml file to use for validation. The cmdlet checks the new test collection against the validation collection to ensure that at least one result exists. Validation helps to determine that all the tests merged from child lab collections meet the goals of the original test collection.

To obtain a test collection file for validation, use the New-HwCertTestCollection cmdlet, along with the Export-HwCertTestCollectionToXml cmdlet.

Type:String
Aliases:XML
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Outputs

Microsoft.Windows.Kits.Hardware.Certification.TestCollectionRecord