Enable-AppvClientConnectionGroup
Enables a running connection group on the computer running the App-V client.
Syntax
ByGuid (Default)
Enable-AppvClientConnectionGroup
[-GroupId] <Guid>
[-VersionId] <Guid>
[-Global]
[-UserSID <String>]
[<CommonParameters>]
ByName
Enable-AppvClientConnectionGroup
[-Name] <String>
[-Global]
[-UserSID <String>]
[<CommonParameters>]
ByConnectionGroup
Enable-AppvClientConnectionGroup
[-ConnectionGroup] <AppvClientConnectionGroup>
[-Global]
[-UserSID <String>]
[<CommonParameters>]
Description
The Enable-AppvClientConnectionGroup cmdlet enables a connection group to the computer that runs the Microsoft Application Virtualization (App-V) client.
Examples
Example 1: Enable a connection group by using its name
PS C:\> Enable-AppvClientConnectionGroup -Name "MyGroup" -Global
This command enables the connection group named MyGroup to all users on the computer.
Example 2: Enable a connection group by using its ID
PS C:\> Enable-AppvClientConnectionGroup -GroupID 35ec9e5f-ab21-463f-8fe6-b90d4b66d182
This command enables the connection group that has the group ID 35ec9e5f-ab21-463f-8fe6-b90d4b66d182.
Example 3: Enable all connection groups by names that match a string
PS C:\> Get-AppvClientConnectionGroup -Name "MyGr*" | Enable-AppvClientConnectionGroup
This command finds all connection groups that have the string MyGr in the name, and then enables them.
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 |
-Global
Indicates that this cmdlet enables the connection group is disabled for all users that log into the target computer. Otherwise, it enables the connection group only for the currently running user.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-GroupId
Specifies the ID associated with a 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 |
-UserSID
Specifies the SID of the intended user, in the form of S-1-2-34-56789012-3456789012-345678901-2345. This parameter requires elevated rights to run.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-VersionId
Specifies a GUID that differentiates a connection group version from other versions. If you do not specify this parameter, the cmdlet operates on all versions of the connection group.
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
- The cmdlet checks that you have permissions to perform the specific action. If not, the cmdlet returns the following error: The action could not be performed due to current App-V permissions. Please modify the permissions and try the operation again.
- If the enable operation fails, the cmdlet returns the following error: The enable operation could not be completed. An error code is returned.
- If any package in the specified group is running, the connection group will not be enabled until all packages in the new group are shutdown. The cmdlet will still return success as long as the file is valid.
- If the cmdlet cannot find the connection group, the cmdlet returns an error stating The specified connection group could not be found on the target system.