Edit

Share via


Install-ProvisioningPackage

Install .PPKG package onto the local machine.

Syntax

Default (Default)

Install-ProvisioningPackage
    [-PackagePath] <String>
    [-ForceInstall]
    [-QuietInstall]
    [-LogsDirectoryPath <String>]
    [-WprpFile <String>]
    [-ConnectedDevice]
    [<CommonParameters>]

Description

This cmdlet is used to install .ppkg files that are generated and exported by the Windows Configuration Designer tool.

The Install-ProvisioningPackage cmdlet is supported on Windows 11 client operating system only.

You can use this cmdlet to install a .ppkg file interactively or silently by specifying the -QuietInstall switch parameter.

The default is an interactive install.

Examples

Example 1

PS C:\> Install-ProvisioningPackage -PackagePath C:\mypackage.ppkg -QuietInstall

This will install the mypackage.ppkg file silently without customer interaction.

Parameters

-ConnectedDevice

Install package to removable media.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:Device

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ForceInstall

Force the installation of the package.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:Force

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-LogsDirectoryPath

Specifies the logs directory path.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False
Aliases:Logs

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-PackagePath

Path to provisioning package

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False
Aliases:Path

Parameter sets

(All)
Position:0
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-QuietInstall

Quietly installs the package without any customer interaction.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:Quiet

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-WprpFile

Specifies the name of a WPR profile file.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False
Aliases:Wprp

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

None

Outputs

Object