< Back

Remove-AppvClientConnectionGroup

Tue Jan 29, 2019 9:24 pm

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