New-HwCertTestCollection

New-HwCertTestCollection

Creates a test collection file from a project definition file.

Syntaxe

Parameter Set: Default
New-HwCertTestCollection [-ProjectDefinitionFile] <String> [ <CommonParameters>]

Description détaillée

The New-HwCertTestCollection cmdlet creates a test collection file from a Windows Hardware Certification Kit (HCK) project definition file. The collection file represents the testing scope of a unique combination of test and target and version of the Windows operating system. 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 this test collection file in several ways at different stages of the testing workflow, including the following:

-- Generate an initial test collection to understand the full scope of testing.
-- Filter the test collection based on test metadata and properties, and then generate smaller collections for different labs to run.
-- Use a test collection with results to control the scope of testing. For instance, the tests could skip all passing tests.
-- Use a test collection as a validation file when you merge test results from the smaller collections.

The cmdlet creates temporary projects and target families to enumerate all the possible tests. You can reuse the generated project for additional testing outside of the automation workflow by using tools from the HCK.

Use the New-HwCertProjectDefinitionFile cmdlet to create a project definition file.

Paramètres

-ProjectDefinitionFile<String>

Specifies the project definition file as a full path. To create a project definition file, use the New-HwCertProjectDefinitionFile cmdlet.

Alias

Input,PDF,Project

Obligatoire ?

true

Position ?

1

Valeur par défaut

none

Accepter l’entrée de pipeline ?

false

Accepter les caractères génériques ?

false

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d’informations, consultez about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Entrées

Le type d’entrée correspond au type des objets que vous pouvez transmettre à l’applet de commande.

Sorties

Le type de sortie est le type des objets émis par l’applet de commande.

  • Microsoft.Windows.Kits.Hardware.Certification.TestCollectionRecord

Exemples

Example 1: Create a test collection

This command creates a test collection based on the project definition file named ProjectDefinitionWindows8Client.xml.

PS C:\> New-HwCertTestCollection -ProjectDefinitionFile "C:\Temp\ProjectDefinitionWindows8Client.xml"

Example 2: Create a test collection and export it to a filea

This command creates a test collection and then exports it to an .xml file. This command creates a test collection based on the project definition file named ProjectDefinitionWindows8Client.xml, and then passes the test collection to the Export-HwCertTestCollectionToXml cmdlet by using the pipeline operator. That cmdlet exports it to a file called TestCollectionWindows8Client.xml.

PS C:\> New-HwCertTestCollection -ProjectDefinitionFile "C:\Temp\ProjectDefinitionWindows8Client.xml" | Export-HwCertTestCollectionToXml -Output "C:\Temp\TestCollectionWindows8Client.xml"

Rubriques connexes

Export-HwCertTestCollectionToXml

New-HwCertProjectDefinitionFile