編集

次の方法で共有


Unpublish-AppvClientPackage

Removes the extension points for packages.

Syntax

ByGuid (Default)

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

ByPackage

Unpublish-AppvClientPackage
    [-Package] <AppvClientPackage>
    [-Global]
    [-UserSID <String>]
    [<CommonParameters>]

ByName

Unpublish-AppvClientPackage
    [-Name] <String>
    [[-Version] <String>]
    [-Global]
    [-UserSID <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.

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

-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.

Parameter properties

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

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 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.

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