Get-AppvClientPackage
Returns App-V Client Packages.
Syntax
ByName (Default)
Get-AppvClientPackage
[[-Name] <String>]
[[-Version] <String>]
[-All]
[<CommonParameters>]
ByGuid
Get-AppvClientPackage
[-PackageId] <Guid>
[[-VersionId] <Guid>]
[-All]
[<CommonParameters>]
Description
The Get-AppvClientPackage cmdlet returns a set of Microsoft Application Virtualization (App-V) Client Packages based on the criteria provided.
Examples
Example 1: Get packages that have names that match a string
PS C:\> Get-AppvClientPackage -Name "MyApp*" -All
This command gets the set of packages that have names that start with the string MyApp.
Example 2: Get a specific version of a package by name
PS C:\> Get-AppvClientPackage -Name "MyApp" -Version 4
This command gets the version 4 of the package named MyApp.
Example 3: Get a package by using its package ID
PS C:\> Get-AppvClientPackage -PackageID 793afd37-bd68-4ea1-859a-669f6afd0aa8
This command gets the package with the package ID of 793afd37-bd68-4ea1-859a-669f6afd0aa8.
Parameters
-All
Indicates that the cmdlet uses the set of all packages added to the computers as the searchable set. If not provided, the cmdlet only uses packages that are entitled to the current 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: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | 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 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 |
-Version
Specifies the version of an App-V package in one specific lineage. If you do not specify this parameter, the cmdlet operates on available versions of the package on the target computer.
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 the GUID that differentiates a package version from other versions, whether older, newer, or of a different lineage. If you do specify this parameter, the cmdlet operates on all versions of a package.
Parameter properties
| Type: | Guid |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
ByGuid
| Position: | 1 |
| Mandatory: | False |
| 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.
Outputs
Microsoft.AppV.AppvClientPowerShell.AppvClientPackage
Notes
- If you do not specify any parameters, the cmdlet returns a set of all packages on the computer.
- The cmdlet checks that you have permissions to perform the specific action. If not, the cmdlet returns the following error: The action could not be performed due to current App-V permissions. Please modify the permissions and try the operation again.
- If the cmdlet cannot find the package, the cmdlet returns the following error: The specified package(s) could not be found. An error code is returned.