Edit

Update-AppvServerConnectionGroup

  • Reference
Module:
AppVServer

Updates the specified connection group.

Syntax

Update-AppvServerConnectionGroup
      [-AppvServerConnectionGroup] <SerializableConnectionGroup>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AppvServerConnectionGroup
      [-Name] <String>
      [[-Version] <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

The Update-AppvServerConnectionGroup cmdlet updates a connection group. This cmdlet increments the version of the package group in the server management console.

Examples

Example 1: Update a group

PS C:\> Update-AppvServerConnectionGroup -Name "Office" | Set-AppvServerConnectionGroup $Package01 $Package02

This command updates the group named Office, and then sets two packages to be in the group.

Example 2: Get an updated version

PS C:\> $Group = Get-AppvServerPackage -PackageGUID A1232ACFD3EF
PS C:\> Update-AppvServerConnectionGroup -Name $Package.Name

This example returns an updated version of $Group. The new version contains no package groups. Note that $Group could contain multiple versions of the package group, but the cmdlet uses the latest version of the package group to create the new version.

Example 3: Store an updated version in a variable

PS C:\> $Group = Get-AppvServerConnectionGroup -Name "Office"
PS C:\> $Group02 = $Group.Update()

This example returns an updated version of $Group, and stores it in $Group02. The $Group02 variable contains no packages.

Parameters

-AppvServerConnectionGroup

Specifies the package group object.

Type:SerializableConnectionGroup
Position:1
Default value:None
Required:True
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

-Name

Specifies the name of the package group.

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

-Version

Type:Int32
Position:2
Default value:None
Required:False
Accept pipeline input:False
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

Outputs

AppvServer.AppvServerPackageGroup

Notes

  • This cmdlet returns an AppvServerPackageGroup object that references the updated version of the package group.
  • You must specify the name of an existing package group. If the group does not exist, the cmdlet returns the following error: The specified package group could not be found on the system.
  • This cmdlet returns an empty package group with its server version incremented. The version GUID will NOT be incremented until you run the Set-AppvServerPackageGroup cmdlet.