Stop-AppvClientConnectionGroup

Shuts down the shared virtual environment of a connection group.

Syntax

Stop-AppvClientConnectionGroup
    [-Global]
    [-GroupId] <Guid>
    [-VersionId] <Guid>
    [<CommonParameters>]
Stop-AppvClientConnectionGroup
    [-Global]
    [-Name] <String>
    [<CommonParameters>]
Stop-AppvClientConnectionGroup
    [-Global]
    [-ConnectionGroup] <AppvClientConnectionGroup>
    [<CommonParameters>]

Description

The Stop-AppvClientConnectionGroup cmdlet shuts down the shared virtual environment of a connection group. All running processes within the connection group virtual environment are shutdown.

Examples

Example 1: Stop a virtual environment for a named group

PS C:\> Stop-AppvClientConnectionGroup -Name "MyGroup"

This command stops the virtual environment of the enabled connection group that has the name MyGroup.

Example 2: Stop a virtual environment for a group by using its ID

PS C:\> Stop-AppvClientConnectionGroup -GroupID 793afd37-bd68-4ea1-859a-669f6afd0aa8

This command stops the virtual environment of the enabled connection group with the group ID 793afd37-bd68-4ea1-859a-669f6afd0aa8.

Example 3: Stop virtual environment for groups with names that match a string

PS C:\> Get-AppvClientConnectionGroup -Name "MyGr*" | Stop-AppvClientConnectionGroup

This command gets all of the enabled connection groups that have the string MyGr in the name, and then stops each of their virtual environments.

Parameters

-ConnectionGroup

Not Specified

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

-Global

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

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

-GroupId

Specifies the group ID of a specific connection group.

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

-Name

Specifies the name of the Microsoft Application Virtualization (App-V) connection group.

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

-VersionId

Specifies a GUID that differentiates a connection group 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 connection group.

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

Inputs

Microsoft.AppvAgent.AppvClientConnectionGroup

Notes

  • The cmdlet checks that you have permissions to perform the specific action. If not, the cmdlet returns an error.
  • If the enable operation fails, the cmdlet returns an error.
  • If the cmdlet cannot find the connection group on the target computer, the cmdlet returns an error.