Edit

Share via

Remove-AppvClientConnectionGroup

Module:
AppvClient Module

Deletes an App-V connection group on the client.

Syntax

ByGuid (Default) 

Remove-AppvClientConnectionGroup
    [-GroupId] <Guid>
    [-VersionId] <Guid>
    [<CommonParameters>]

ByName 

Remove-AppvClientConnectionGroup
    [-Name] <String>
    [<CommonParameters>]

ByConnectionGroup 

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.

Parameter properties

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

Parameter sets

ByConnectionGroup
Position:0
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-GroupId

Specifies the GUID of specific connection group.

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

-Name

Specifies the name of the App-V Connection Group.

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

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

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