< Back
Test-MSIProduct
Post
NAME Test-MSIProduct
SYNOPSIS
Runs internal consistency evaluators (ICEs) against the product package or packages.
SYNTAX
Test-MSIProduct [-AdditionalCube <String[]>] [-Exclude <String[]>] [-Include <String[]>] -LiteralPath <String[]>
[-NoDefault] [-Patch <String[]>] [-Transform <String[]>] [<CommonParameters>]
Test-MSIProduct [-Path] <String[]> [-AdditionalCube <String[]>] [-Exclude <String[]>] [-Include <String[]>]
[-NoDefault] [-Patch <String[]>] [-Transform <String[]>] [<CommonParameters>]
DESCRIPTION
Internal consistency evaluators (ICEs) are custom actions that validate whether a product is authored as
specified. If Orca or MsiVal2 is installed, the default ICE .cub ("ICE cube") file is used by default, and you can
specify custom ICE cube.
You can also apply any number of patches or transforms before running ICEs. This allows you to evaluate a product
that is transformed by, for example, a patch to also make sure the changes made by a patch or valid.
PARAMETERS
-AdditionalCube <String[]>
One or more ICE .cub files to use for evaluation.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Exclude <String[]>
The names of ICEs to exclude from evaluation (all other ICEs are included).
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? true
-Include <String[]>
The names of ICEs to include from evaluation (all other ICEs are excluded).
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? true
-LiteralPath <String[]>
The path to a package to evaluate. The value of -LiteralPath is used exactly as typed. No characters are
interpreted as wildcards.
Required? true
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-NoDefault [<SwitchParameter>]
Do not import darice.cub if installed with Orca or MsiVal2.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-Patch <String[]>
The path to a patch package or packages to apply to the product package before evaluation. Patches are applied
in sequence order.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? true
-Path <String[]>
The path to a package to evaluate. Wildcards are permitted. You can specify * in any part of the path to
select all matching files.
Required? true
Position? 1
Default value None
Accept pipeline input? True (ByPropertyName, ByValue)
Accept wildcard characters? true
-Transform <String[]>
The path to a transform or transforms to apply to the product package before evaluation.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? true
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
Microsoft.Tools.WindowsInstaller.IceMessage
NOTES
-------------------------- EXAMPLE 1 --------------------------
test-msiproduct .\\example.msi -include ICE0* -exclude ICE03 -v
Output all messages from ICEs 01 through 09 except for ICE03.
-------------------------- EXAMPLE 2 --------------------------
test-msiproduct .\\example.msi -patch .\\example.msp -add .\\tests\\custom.cub
Apply example.msp to example.msi, then run all the default and custom ICEs.
RELATED LINKS
SYNOPSIS
Runs internal consistency evaluators (ICEs) against the product package or packages.
SYNTAX
Test-MSIProduct [-AdditionalCube <String[]>] [-Exclude <String[]>] [-Include <String[]>] -LiteralPath <String[]>
[-NoDefault] [-Patch <String[]>] [-Transform <String[]>] [<CommonParameters>]
Test-MSIProduct [-Path] <String[]> [-AdditionalCube <String[]>] [-Exclude <String[]>] [-Include <String[]>]
[-NoDefault] [-Patch <String[]>] [-Transform <String[]>] [<CommonParameters>]
DESCRIPTION
Internal consistency evaluators (ICEs) are custom actions that validate whether a product is authored as
specified. If Orca or MsiVal2 is installed, the default ICE .cub ("ICE cube") file is used by default, and you can
specify custom ICE cube.
You can also apply any number of patches or transforms before running ICEs. This allows you to evaluate a product
that is transformed by, for example, a patch to also make sure the changes made by a patch or valid.
PARAMETERS
-AdditionalCube <String[]>
One or more ICE .cub files to use for evaluation.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Exclude <String[]>
The names of ICEs to exclude from evaluation (all other ICEs are included).
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? true
-Include <String[]>
The names of ICEs to include from evaluation (all other ICEs are excluded).
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? true
-LiteralPath <String[]>
The path to a package to evaluate. The value of -LiteralPath is used exactly as typed. No characters are
interpreted as wildcards.
Required? true
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-NoDefault [<SwitchParameter>]
Do not import darice.cub if installed with Orca or MsiVal2.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-Patch <String[]>
The path to a patch package or packages to apply to the product package before evaluation. Patches are applied
in sequence order.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? true
-Path <String[]>
The path to a package to evaluate. Wildcards are permitted. You can specify * in any part of the path to
select all matching files.
Required? true
Position? 1
Default value None
Accept pipeline input? True (ByPropertyName, ByValue)
Accept wildcard characters? true
-Transform <String[]>
The path to a transform or transforms to apply to the product package before evaluation.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? true
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
Microsoft.Tools.WindowsInstaller.IceMessage
NOTES
-------------------------- EXAMPLE 1 --------------------------
test-msiproduct .\\example.msi -include ICE0* -exclude ICE03 -v
Output all messages from ICEs 01 through 09 except for ICE03.
-------------------------- EXAMPLE 2 --------------------------
test-msiproduct .\\example.msi -patch .\\example.msp -add .\\tests\\custom.cub
Apply example.msp to example.msi, then run all the default and custom ICEs.
RELATED LINKS