< Back
Remove-AppvClientConnectionGroup
Post
NAME Remove-AppvClientConnectionGroup
SYNOPSIS
Deletes an App-V connection group on the client.
SYNTAX
Remove-AppvClientConnectionGroup [-ConnectionGroup] <AppvClientConnectionGroup> [<CommonParameters>]
Remove-AppvClientConnectionGroup [-GroupId] <Guid> [-VersionId] <Guid> [<CommonParameters>]
Remove-AppvClientConnectionGroup [-Name] <String> [<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.
PARAMETERS
-ConnectionGroup <AppvClientConnectionGroup>
Specifies an App-V Connection Group object.
Required? true
Position? 1
Default value none
Accept pipeline input? true(ByValue)
Accept wildcard characters? false
-GroupId <Guid>
Specifies the GUID of specific connection group.
Required? true
Position? 1
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-Name <String>
Specifies the name of the App-V Connection Group.
Required? true
Position? 1
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-VersionId <Guid>
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.
Required? true
Position? 2
Default value none
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
Microsoft.AppvAgent.AppvClientConnectionGroup
OUTPUTS
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.
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.
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/?LinkId=827716
Add-AppvClientConnectionGroup
Disable-AppvClientConnectionGroup
Enable-AppvClientConnectionGroup
Get-AppvClientConnectionGroup
Mount-AppvClientConnectionGroup
Repair-AppvClientConnectionGroup
Stop-AppvClientConnectionGroup
SYNOPSIS
Deletes an App-V connection group on the client.
SYNTAX
Remove-AppvClientConnectionGroup [-ConnectionGroup] <AppvClientConnectionGroup> [<CommonParameters>]
Remove-AppvClientConnectionGroup [-GroupId] <Guid> [-VersionId] <Guid> [<CommonParameters>]
Remove-AppvClientConnectionGroup [-Name] <String> [<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.
PARAMETERS
-ConnectionGroup <AppvClientConnectionGroup>
Specifies an App-V Connection Group object.
Required? true
Position? 1
Default value none
Accept pipeline input? true(ByValue)
Accept wildcard characters? false
-GroupId <Guid>
Specifies the GUID of specific connection group.
Required? true
Position? 1
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-Name <String>
Specifies the name of the App-V Connection Group.
Required? true
Position? 1
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-VersionId <Guid>
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.
Required? true
Position? 2
Default value none
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
Microsoft.AppvAgent.AppvClientConnectionGroup
OUTPUTS
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.
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.
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/?LinkId=827716
Add-AppvClientConnectionGroup
Disable-AppvClientConnectionGroup
Enable-AppvClientConnectionGroup
Get-AppvClientConnectionGroup
Mount-AppvClientConnectionGroup
Repair-AppvClientConnectionGroup
Stop-AppvClientConnectionGroup