Repair-AppvClientPackage
Resets the user settings of a package.
Syntax
Repair-AppvClientPackage
[-Global]
[-UserState]
[-Extensions]
[-PackageId] <Guid>
[-VersionId] <Guid>
[<CommonParameters>] Repair-AppvClientPackage
[-Global]
[-UserState]
[-Extensions]
[-Package] <AppvClientPackage>
[<CommonParameters>] Repair-AppvClientPackage
[-Global]
[-UserState]
[-Extensions]
[-Name] <String>
[[-Version] <String>]
[<CommonParameters>] Description
The Repair-AppvClientPackage cmdlet deletes the user settings and reset the extension points of the package. Resetting the settings causes permanent loss of any user-specific application settings in the package. The settings are reset to their original state when the package was originally added to the system.
Examples
Example 1: Delete user state for a version of a package
PS C:\> Repair-AppvClientPackage -Name "MyApp" -Version 3This command deletes the user state of version 3 of the package named MyApp.
Example 2: Delete user state for packages that have a name that matches a string
PS C:\> Get-AppvClientPackage -Name "MyA*" | Repair-AppvClientPackageThis command gets all packages that have the string MyA in the name, and then delete the user state for those packages.
Parameters
-Extensions
Indicates that this cmdlet repairs the extension points of a package only, and does not delete the user state of the package.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Global
Indicates that this cmdlet repairs the extension points for the provided packages for all users that log into the targeted computer. Otherwise, the extension points of the packages are only repaired for the currently running user.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Specifies the friendly name of the package given during Sequencing time. This value is obtained from the package manifest.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Package
Specifies an App-V package.
| Type: | AppvClientPackage |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PackageId
Specifies a GUID that uniquely identifies the package. It can be found in the package manifest or by opening the package in the Microsoft Application Virtualization (App-V) Sequencer. The Package ID is shared by all versions of a package.
| Type: | Guid |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserState
Indicates that the cmdlet deletes the user state of the package only, and does not perform a repair on the extension points.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Version
Specifies the version of an App-V package in a lineage. If you do not specify this parameter, the cmdlet operates on all versions on the computer.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VersionId
Specifies the GUID that differentiates a package version from other versions, whether older, newer, or of a different lineage. If you do not specify this parameter, the cmdlet operates on all versions of the package.
| Type: | Guid |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Inputs
Microsoft.AppvAgent.AppvClientPackage
Outputs
Microsoft.AppvAgent.AppvClientPackage