Merge-HwCertTestCollectionFromXml
Merge-HwCertTestCollectionFromXml
Merges test result information from several test collection files into a single test collection.
Syntax
Parameter Set: Default
Merge-HwCertTestCollectionFromXml [-LiteralPath] <String[]> [-HckBuildVersion <String> ] [-ValidationXmlPath <String> ] [ <CommonParameters>]
Detailed 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 (HCK) (https://msdn.microsoft.com/en-us/library/windows/hardware/hh833788.aspx) 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.
Parameters
-HckBuildVersion<String>
Specifies an HCK build version. This cmdlet merges the results that match this build version only.
Aliases |
Build,Version |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-LiteralPath<String[]>
Specifies an array full paths. These are file paths to test collection .xml files.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
True (ByValue) |
Accept Wildcard Characters? |
false |
-ValidationXmlPath<String>
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.
Aliases |
XML |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
- Microsoft.Windows.Kits.Hardware.Certification.TestCollectionRecord
Examples
Example 1: Merge two test collection files
This command merges the results in two test collection files. The command specifies files named BasicTest.xml and CertificationTest.xml.
PS C:\> Merge-HwCertTestCollectionFromXml -LiteralPath ("C:\Temp\BasicTest.xml", "C:\Temp\CertificationTest.xml")
Example 2: Merge two test collection files and export the result information
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.
PS C:\> Merge-HwCertTestCollectionFromXml -LiteralPath ("C:\Temp\BasicTest.xml", "C:\Temp\CertificationTest.xml") | Export-HwCertTestCollectionToXml -Output "C:\Temp\Merged.xml"
Example 3: Merge several test collection files and export the result information
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.
PS C:\> Get-ChildItem -Recurse "C:\Temp\*.xml" | Merge-HwCertTestCollectionFromXml | Export-HwCertTestCollectionToXml -Output "C:\Temp\Merged.xml"
Related topics
Export-HwCertTestCollectionToXml