Edit

Share via

Publish-AppvClientPackage

Module:
AppvClient Module

Publishes the App-V package.

Syntax

ByGuid (Default) 

Publish-AppvClientPackage
    [[-DynamicUserConfigurationPath] <String>]
    [-PackageId] <Guid>
    [-VersionId] <Guid>
    [-Global]
    [-UserSID <String>]
    [-DynamicUserConfigurationType <DynamicUserConfiguration>]
    [<CommonParameters>]

ByPackage 

Publish-AppvClientPackage
    [[-DynamicUserConfigurationPath] <String>]
    [-Package] <AppvClientPackage>
    [-Global]
    [-UserSID <String>]
    [-DynamicUserConfigurationType <DynamicUserConfiguration>]
    [<CommonParameters>]

ByName 

Publish-AppvClientPackage
    [[-DynamicUserConfigurationPath] <String>]
    [-Name] <String>
    [[-Version] <String>]
    [-Global]
    [-UserSID <String>]
    [-DynamicUserConfigurationType <DynamicUserConfiguration>]
    [<CommonParameters>]

Description

The Publish-AppvClientPackage cmdlet publishes the appropriate extension points of a set of Microsoft Application Virtualization (App-V) packages. Examples of common extension points include shortcuts and FTAs. You can publish the package to the current user or to all users that log into the targeted computer. You can also provide a Dynamic User Configuration file for the package.

Examples

Example 1: Publish a version of a package to all users

PS C:\> Publish-AppvClientPackage -Name "MyApp" -Version 1 -Global -DynamicUserConfiguration "C:\content\policies\MyApp.policy"

This command publishes version 1 of the package named MyApp to all users on the computer and applies the Dynamic User Configuration policy file.

Example 2: Publish a version of a package to a user

PS C:\> Publish-AppvClientPackage -Name "MyApp" -Version 1 -UserPolicy "C:\content\policies\MyAppConfiguration.xml"

This command publishes version 1 of the package named "MyApp" to the user and applies the Dynamic User Configuration policy file.

Example 3: Publish the latest version of a package to all users

PS C:\> Publish-AppvClientPackage -Name "MyApp" -Global

This command publishes the package named MyApp to all users on the computer.

Parameters

-DynamicUserConfigurationPath

Specifies the path of a Dynamic User configuration file for the specified App-V package to be added. The cmdlet uses the Dynamic User Configuration file to override the default behavior provided in the user section of the package manifest or the Dynamic Deployment Configuration.

Parameter properties

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

Parameter sets

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

-DynamicUserConfigurationType

Specifies what should be done without a defined dynamic user configuration file. The acceptable values for this parameter are:

  • UseDeploymentConfiguration. The package uses the user configuration part of deployment configuration.
  • UseNoConfiguration. Clear any previous configuration and use settings from the manifest.
  • UseExistingConfiguration. Make no changes to the configuration and use the last published configuration.

If you do not specify this parameter, this cmdlet uses UseExistingConfiguration if the package is already published or UseDeploymentConfiguration if it is not.

Use this parameter only during user publishing. It is not valid for global publish.

Parameter properties

Type:DynamicUserConfiguration
Default value:None
Accepted values:UseDeploymentConfiguration, UseNoConfiguration, UseExistingConfiguration
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 the provided package is published to all users that log into the targeted computer. Otherwise, the packages are only published 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 name of the package given when it was sequenced. 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 identifies the package. The information can be found in the package manifest or by opening the package in the 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 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 a lineage. If you do not specify this parameter, the cmdlet operates on the latest of the package on the computer running the App-V client.

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