Edit

Unpublish-AppvServerPackage

  • Reference
Module:
AppVServer

Unpublishes packages.

Syntax

Unpublish-AppvServerPackage
         [[-Name] <String>]
         [[-Version] <String>]
         [-WhatIf]
         [-Confirm]
         [<CommonParameters>]
Unpublish-AppvServerPackage
         [-AppvServerPackage] <PackageVersion[]>
         [-WhatIf]
         [-Confirm]
         [<CommonParameters>]
Unpublish-AppvServerPackage
         [-PackageID] <Guid>
         [[-VersionID] <Guid>]
         [-WhatIf]
         [-Confirm]
         [<CommonParameters>]

Description

The Unpublish-AppvServerPackage cmdlet unpublishes a package. All connected publishing servers no longer push the specified packages to entitled users.

Examples

1:

Parameters

-AppvServerPackage

Specifies an array of AppVServerPackage objects.

Type:PackageVersion[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Prompts you for confirmation before running the cmdlet.Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Specifies the friendly name of the package given when the package was created. This value is obtained from the package manifest.

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

-PackageID

Specifies the 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 GUID is shared by all versions of a package.

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

-Version

Specifies the version of an App-V package in a lineage. If you do not specify a version, the cmdlet acts on all versions saved on the computer.

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

-VersionID

Specifies a GUID that differentiates a package version from other versions, whether older, newer, or of a completely different lineage. If you do not specify this parameter, the cmdlet operates on all versions of the package.

Type:Guid
Position:2
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

AppvServer.AppvServerPackage

Notes

  • If the packages do not exist, the unpublish operation fails for those packages. The cmdlet returns the following error: The following packages could not be found on the system <list of packages>.
  • If you do not specify version information, the cmdlet unpublishes all versions of the package.
  • If you do not specify any parameters, the cmdlet unpublishes all packages on the computer. The cmdlet returns a warning before it runs this operation.