Edit

Share via


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 3

This 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-AppvClientPackage

This 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