Edit

Share via

Remove-AppvClientConnectionGroup

  • Reference
Module:
AppvClient

Deletes an App-V connection group on the client.

Syntax

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

Description

The Remove-AppvClientConnectionGroup cmdlet deletes an existing Microsoft Application Virtualization (App-V) connection group on the client. All packages that were in the group are separated.

Examples

Example 1: Remove a named connection group

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

This command removes the connection group named MyGroup from the computer.

Example 2: Remove a connection group by using its ID

PS C:\> Remove-AppvClientConnectionGroup -GroupID 35ec9e5f-ab21-463f-8fe6-b90d4b66d182

This command removes the connection group that has the group ID 35ec9e5f-ab21-463f-8fe6-b90d4b66d182.

Example 3: Remove all connection groups that have names that match a string

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

This command finds any connection group that has the string MyGr in the name, and then removes them from the computer.

Parameters

-ConnectionGroup

Specifies an App-V Connection Group object.

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

-GroupId

Specifies the GUID of 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 App-V Connection Group.

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

-VersionId

Specifies the 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 all versions of the package.

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

Inputs

Microsoft.AppvAgent.AppvClientConnectionGroup

Notes

  • If any packages in the group are still running, the cmdlet returns an error.
  • The cmdlet checks that you have permissions to perform the specific action. If not, the cmdlet returns an error.
  • If the remove operation fails, the cmdlet returns the following error: The remove operation could not be completed. An error code is returned.
  • If any package in the specified group is running, the connection group is not removed until all packages in the new group are shutdown. The cmdlet still returns success as long as the file is valid.