Set-AppvServerConnectionGroup

Mis à jour: décembre 2014

S'applique à: Application Virtualization 5.0, Application Virtualization 5.0 SP1, Application Virtualization 5.0 SP2, Application Virtualization 5.0 SP3

Set-AppvServerConnectionGroup

Configures an App-V server package group.

Syntaxe

Parameter Set: ByGUID
Set-AppvServerConnectionGroup [-GroupID] <Guid> [[-VersionID] <Guid> ] [[-AppvServerPackage] <PackageVersion[]> ] [-Order <Int32[]> ] [-Priority <UInt32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: ByName
Set-AppvServerConnectionGroup [-Name] <String> [[-Version] <Int32> ] [[-AppvServerPackage] <PackageVersion[]> ] [-Order <Int32[]> ] [-Priority <UInt32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: ByObject
Set-AppvServerConnectionGroup [-AppvServerConnectionGroup] <SerializableConnectionGroup> [[-AppvServerPackage] <PackageVersion[]> ] [-Order <Int32[]> ] [-Priority <UInt32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]




Description détaillée

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

The cmdlet returns an AppvServerConnectionGroup object.

Paramètres

-AppvServerConnectionGroup<SerializableConnectionGroup>

Specifies the connection group object.


Alias

none

Obligatoire ?

true

Position ?

1

Valeur par défaut

none

Accepter l’entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-AppvServerPackage<PackageVersion[]>

Specifies an array of AppVServerPackage objects.


Alias

none

Obligatoire ?

false

Position ?

3

Valeur par défaut

none

Accepter l’entrée de pipeline ?

True (ByValue)

Accepter les caractères génériques ?

false

-GroupID<Guid>

Specifies the GUID of specific package group.


Alias

none

Obligatoire ?

true

Position ?

1

Valeur par défaut

none

Accepter l’entrée de pipeline ?

True (ByValue)

Accepter les caractères génériques ?

false

-Name<String>

Specifies the name of the package group.


Alias

none

Obligatoire ?

true

Position ?

1

Valeur par défaut

none

Accepter l’entrée de pipeline ?

True (ByValue)

Accepter les caractères génériques ?

false

-Order<Int32[]>

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.


Alias

none

Obligatoire ?

false

Position ?

named

Valeur par défaut

none

Accepter l’entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Priority<UInt32>

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.


Alias

none

Obligatoire ?

false

Position ?

named

Valeur par défaut

none

Accepter l’entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Version<Int32>

Specifies the version of the specified package group.


Alias

none

Obligatoire ?

false

Position ?

2

Valeur par défaut

none

Accepter l’entrée de pipeline ?

True (ByValue)

Accepter les caractères génériques ?

false

-VersionID<Guid>

Specifies the version GUID of the package group.


Alias

none

Obligatoire ?

false

Position ?

2

Valeur par défaut

none

Accepter l’entrée de pipeline ?

True (ByValue)

Accepter les caractères génériques ?

false

-Confirm

Votre confirmation sera requise avant l’exécution de l’applet de commande.


Obligatoire ?

false

Position ?

named

Valeur par défaut

false

Accepter l’entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-WhatIf

Présente les conséquences éventuelles de l’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.


Obligatoire ?

false

Position ?

named

Valeur par défaut

false

Accepter l’entrée de pipeline ?

false

Accepter les caractères génériques ?

false

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d’informations, consultez about_CommonParameters (http://go.microsoft.com/fwlink/p/?LinkID=113216).

Entrées

Le type d’entrée correspond au type des objets que vous pouvez transmettre à l’applet de commande.

  • AppvServer.AppvServerPackage, AppvServer.AppvServerConnectionGroup

Sorties

Le type de sortie est le type des objets émis par l’applet de commande.

  • AppvServer.AppvServerConnectionGroup

Remarques

  • 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.

Exemples

Example 1: Modify a package group

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.


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 

Example 2: Modify priority and order properties

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.


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

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

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.


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

Example 4: Add packages and metadata

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.


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

Rubriques connexes

Ajouts de la communauté

AJOUTER
Afficher: