Edit

Set-AppvServerConnectionGroup

  • Reference
Module:
AppVServer

Configures an App-V server package group.

Syntax

Set-AppvServerConnectionGroup
   [[-AppvServerPackage] <PackageVersion[]>]
   [-Name] <String>
   [-Priority <UInt32>]
   [-Order <Int32[]>]
   [[-Version] <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AppvServerConnectionGroup
   [[-AppvServerPackage] <PackageVersion[]>]
   [-AppvServerConnectionGroup] <SerializableConnectionGroup>
   [-Priority <UInt32>]
   [-Order <Int32[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AppvServerConnectionGroup
   [[-AppvServerPackage] <PackageVersion[]>]
   [-Priority <UInt32>]
   [-Order <Int32[]>]
   [-GroupID] <Guid>
   [[-VersionID] <Guid>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

The Set-AppvServerConnectionGroup cmdlet sets the packages within the Microsoft Application Virtualization (App-V) specified package group. The cmdlet modifies the packages in the group, as well as the order of those packages.

The cmdlet returns an AppvServerConnectionGroup object.

Examples

Example 1: Modify a package group

PS C:\> $P11 = Get-AppvServerPackage -Name "Item03" -Version 1
PS C:\> $P12 = Get-AppvServerPackage -Name "Item14" -Version 2
PS C:\> $P13 = Get-AppvServerPackage -Name "MyGroup" -Version 3
PS C:\> $Group = New-AppvServerConnectionGroup -Name MyGroup
PS C:\> Set-AppvServerConnectionGroup -AppvServerConnectionGroup $Group -AppVServerPackage $P11,$P12,$P13 -Order 2,0,1 -Priority 1,0,1

This example sets the new package group, $Group, to contain the packages stored in $P11, $P12, $P13. The priority and order fields are also added to each respective package in the group.

Example 2: Modify priority and order properties

PS C:\> $Group.GroupedAppvServerPackage[0].priority = 1
PS C:\> $Group.GroupedAppvServerPackage[0].order = 1
PS C:\> Set-AppvServerConnectionGroup $Group

This example modifies the priority and order properties of the first package object that was added to the group. The example applies the modifications to the group by using the Set-AppvServerPackageGroup cmdlet.

Example 3: Modify a package group by using the pipeline operator

PS C:\> Get-AppvServerPackage -Name "Office" | Set-AppvServerConnectionGroup -Name "MyGroup" -Version 3

This command modifies the package group named MyGroup to contain the Office package. Although the result of the Get-AppvServerPackage cmdlet might contain multiple versions of the package, only the latest version is added to the package group.

Example 4: Add packages and metadata

PS C:\> $Group = New-AppvServerConnectionGroup -Name "MyGroup"
PS C:\> $Group.Set("$Package01, $Package02", "0,0", "1,0")

This example creates a group called MyGroup, and then adds $Package01 and $Package02 to the group. The example includes priority and order metadata for each respective package.

Parameters

-AppvServerConnectionGroup

Specifies the connection group object.

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

-AppvServerPackage

Specifies an array of AppVServerPackage objects.

Type:PackageVersion[]
Position:3
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Prompts you for confirmation before running the cmdlet.Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GroupID

Specifies the GUID of specific package group.

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

-Name

Specifies the name of the package group.

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

-Order

Specifies the order in which a package's virtual environment will be loaded when the package group is invoked on the App-V client.

Specify the order as a comma separated list, with each value corresponding to the list of packages being placed in the group.

If you do not specify this parameter, the order in which the packages are listed will be used as the virtual environment load order.

Type:Int32[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Priority

Specifies a numerical value used to resolve conflicts between Virtual Application Packages that appear in multiple Package Groups. Valid values are: 0 and 1. The default value is 0.

Specify the priority as a comma separated list, with each value corresponding to the list of packages being placed in the group.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Version

Specifies the version of the specified package group.

Type:Int32
Position:2
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-VersionID

Specifies the version GUID of the package group.

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

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

AppvServer.AppvServerPackage, AppvServer.AppvServerConnectionGroup

Outputs

AppvServer.AppvServerConnectionGroup

Notes

  • The cmdlet accepts an ordered list of package groups. This list overwrites the current listing of packages for the specified group and increments the VersionID of the package. The server version will NOT be incremented. All existing metadata associated with the package, such as entitlements, are copied over to the new version.
  • If the cmdlet cannot find a package group, the cmdlet returns the following error: The specified package group could not be found on the system. The cmdlet fails the entire operation.
  • If the cmdlet cannot find any of the specified packages, the cmdlet returns the following error: One or more of the specified packages could not be found on the system. The cmdlet fails the entire operation and returns a listing of the packages.
  • If multiple versions of a package group are selected, the latest version will be updated, and its version incremented. The other package groups are ignored.