Edit

Share via


Repair-AppvClientPackage

Resets the user settings of a package.

Syntax

ByGuid (Default)

Repair-AppvClientPackage
    [-PackageId] <Guid>
    [-VersionId] <Guid>
    [-Global]
    [-UserState]
    [-Extensions]
    [<CommonParameters>]

ByPackage

Repair-AppvClientPackage
    [-Package] <AppvClientPackage>
    [-Global]
    [-UserState]
    [-Extensions]
    [<CommonParameters>]

ByName

Repair-AppvClientPackage
    [-Name] <String>
    [[-Version] <String>]
    [-Global]
    [-UserState]
    [-Extensions]
    [<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.

Parameter properties

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

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

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

Parameter sets

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

-Name

Specifies the friendly name of the package given during Sequencing time. This value is obtained from the package manifest.

Parameter properties

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

Parameter sets

ByName
Position:0
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Package

Specifies an App-V package.

Parameter properties

Type:AppvClientPackage
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ByPackage
Position:0
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:Guid
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ByGuid
Position:0
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-UserState

Indicates that the cmdlet deletes the user state of the package only, and does not perform a repair on the extension points.

Parameter properties

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

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

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

Parameter sets

ByName
Position:1
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:Guid
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ByGuid
Position:1
Mandatory:True
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

Microsoft.AppvAgent.AppvClientPackage

Outputs

Microsoft.AppvAgent.AppvClientPackage