Table of contents
TOC
Collapse the table of content
Expand the table of content

Stop-AppvClientPackage

jamiejdt|Last Updated: 3/8/2017
|
1 Contributor

SYNOPSIS

Shuts down virtual environments for specified packages.

SYNTAX

ByGuid (Default)

Stop-AppvClientPackage [-Global] [-PackageId] <Guid> [-VersionId] <Guid> [<CommonParameters>]

ByPackage

Stop-AppvClientPackage [-Global] [-Package] <AppvClientPackage> [<CommonParameters>]

ByName

Stop-AppvClientPackage [-Global] [-Name] <String> [[-Version] <String>] [<CommonParameters>]

DESCRIPTION

The Stop-AppvClientPackage cmdlet shuts down the virtual environment for the specified packages. All applications and processes within that package are forced to shut down. Any unsaved application data is lost.

EXAMPLES

Example 1: Shut down a virtual environment for a version of a package

PS C:\> Stop-AppvClientPackage -Name "MyPackage" -Version 2

This command shuts down the virtual environment of version 2 of package named MyPackage.

Example 2: Shut down a virtual environment for all versions of a package

PS C:\> Get-AppvClientPackage -Name "MyPackage" | Stop-AppvClientPackage

This command gets all versions of the package named MyPackage, and then shuts down the virtual environment for those results.

PARAMETERS

-Global

Specifies that the cmdlet shuts down virtual environments for the specified packages for all users on the computer. Usage of Global parameter requires administrative privileges.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: 

Required: False
Position: Named
Default value: None
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
Parameter Sets: ByName
Aliases: 

Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Package

Not Specified

Type: AppvClientPackage
Parameter Sets: ByPackage
Aliases: 

Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
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
Parameter Sets: ByGuid
Aliases: 

Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Version

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

Type: String
Parameter Sets: ByName
Aliases: 

Required: False
Position: 1
Default value: None
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 completely different lineage. If you do not specify this parameter, the cmdlet operates on all versions of the package.

Type: Guid
Parameter Sets: ByGuid
Aliases: 

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

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

Microsoft.AppvAgent.AppvClientPackage

OUTPUTS

Microsoft.AppvAgent.AppvClientPackage

NOTES

Add-AppvClientPackage

Get-AppvClientPackage

Mount-AppvClientPackage

Publish-AppvClientPackage

Publish-AppvClientPackage

Remove-AppvClientPackage

Repair-AppvClientPackage

Set-AppvClientPackage

Unpublish-AppvClientPackage

© 2017 Microsoft