Edit

Share via

Unpublish-AppvClientPackage

  • Reference
Module:
AppvClient

Removes the extension points for packages.

Syntax

Unpublish-AppvClientPackage
         [-Global]
         [-UserSID <String>]
         [-PackageId] <Guid>
         [-VersionId] <Guid>
         [<CommonParameters>]
Unpublish-AppvClientPackage
         [-Global]
         [-UserSID <String>]
         [-Package] <AppvClientPackage>
         [<CommonParameters>]
Unpublish-AppvClientPackage
         [-Global]
         [-UserSID <String>]
         [-Name] <String>
         [[-Version] <String>]
         [<CommonParameters>]

Description

The Unpublish-AppvClientPackage cmdlet removes all the extension points of the specified packages. The package contents remain on the target computer. The package is still added on the client and the appropriate AppvClientPackage object persists.

The package can be unpublished for the current user or if all users that log on to the target computer.

Examples

Example 1: Unpublish a version of a package

PS C:\> Unpublish-AppvClientPackage -Name "MyApp" -Version 3

This command unpublishes version 3 of the package named MyApp.

Example 2: Unpublish a version of a package for all users

PS C:\> Unpublish-AppvClientPackage -Name "MyApp" -Version 3 -Global

This command unpublishes version 3 of the package named MyApp for all users on the computer.

Parameters

-Global

Indicates that the packages are unpublished to all users that log into the targeted computer. Otherwise, the packages are only unpublished to 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

-UserSID

Specifies the SID of the intended user, in the form of S-1-2-34-56789012-3456789012-345678901-2345. This cmdlet parameter requires elevated rights to run.

Type:String
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 one specific lineage. If you do not specify this parameter, the cmdlet operates on the latest version found.

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VersionId

Specifies a 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 the latest version 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