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