Start-ADTMspProcess
SYNOPSIS
Executes an MSP file using the same logic as Start-ADTMsiProcess.
SYNTAX
None (Default)
Start-ADTMspProcess -FilePath <String> [-AdditionalArgumentList <String[]>] [-ExpandEnvironmentVariables]
[<CommonParameters>]
RunAsActiveUser
Start-ADTMspProcess -FilePath <String> [-AdditionalArgumentList <String[]>] -RunAsActiveUser <RunAsActiveUser>
[-UseLinkedAdminToken] [-UseHighestAvailableToken] [-InheritEnvironmentVariables] [-DenyUserTermination]
[-ExpandEnvironmentVariables] [<CommonParameters>]
UseUnelevatedToken
Start-ADTMspProcess -FilePath <String> [-AdditionalArgumentList <String[]>] [-UseUnelevatedToken]
[-ExpandEnvironmentVariables] [<CommonParameters>]
DESCRIPTION
Reads SummaryInfo targeted product codes in MSP file and determines if the MSP file applies to any installed products. If a valid installed product is found, triggers the Start-ADTMsiProcess function to patch the installation.
Uses default config MSI parameters. You can use -AdditionalArgumentList to add additional parameters.
EXAMPLES
EXAMPLE 1
Start-ADTMspProcess -FilePath 'Adobe_Reader_11.0.3_EN.msp'
Executes the specified MSP file for Adobe Reader 11.0.3.
EXAMPLE 2
Start-ADTMspProcess -FilePath 'AcroRdr2017Upd1701130143_MUI.msp' -AdditionalArgumentList 'ALLUSERS=1'
Executes the specified MSP file for Acrobat Reader 2017 with additional parameters.
PARAMETERS
-FilePath
Path to the MSP file.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AdditionalArgumentList
Additional parameters.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RunAsActiveUser
A RunAsActiveUser object to invoke the process as.
Type: RunAsActiveUser
Parameter Sets: RunAsActiveUser
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UseLinkedAdminToken
Use a user's linked administrative token while running the process under their context.
Type: SwitchParameter
Parameter Sets: RunAsActiveUser
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-UseHighestAvailableToken
Use a user's linked administrative token if it's available while running the process under their context.
Type: SwitchParameter
Parameter Sets: RunAsActiveUser
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-InheritEnvironmentVariables
Specifies whether the process running as a user should inherit the SYSTEM account's environment variables.
Type: SwitchParameter
Parameter Sets: RunAsActiveUser
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-DenyUserTermination
Specifies that users cannot terminate the process started in their context. The user will still be able to terminate the process if they're an administrator, though.
Type: SwitchParameter
Parameter Sets: RunAsActiveUser
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-UseUnelevatedToken
If the current process is elevated, starts the new process unelevated using the user's unelevated linked token.
Type: SwitchParameter
Parameter Sets: UseUnelevatedToken
Aliases:
Required: True
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-ExpandEnvironmentVariables
Specifies whether to expand any Windows/DOS-style environment variables in the specified FilePath/ArgumentList.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
INPUTS
None
You cannot pipe objects to this function.
OUTPUTS
None
This function does not generate any output.
NOTES
An active ADT session is NOT required to use this function.
Tags: psadt
Website: https://psappdeploytoolkit.com
Copyright: (C) 2025 PSAppDeployToolkit Team (Sean Lillis, Dan Cunningham, Muhammad Mashwani, Mitch Richters, Dan Gough).
License: https://opensource.org/license/lgpl-3-0
RELATED LINKS
https://psappdeploytoolkit.com/docs/reference/functions/Start-ADTMspProcess