Set-AppvServerConnectionGroup

Letzte Aktualisierung: Dezember 2014

Betrifft: 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.

Syntax

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>]




Detaillierte Beschreibung

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.

Parameter

-AppvServerConnectionGroup<SerializableConnectionGroup>

Specifies the connection group object.


Aliasse

none

Erforderlich?

true

Position?

1

Standardwert

none

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-AppvServerPackage<PackageVersion[]>

Specifies an array of AppVServerPackage objects.


Aliasse

none

Erforderlich?

false

Position?

3

Standardwert

none

Pipelineeingaben akzeptieren?

True (ByValue)

Platzhalterzeichen akzeptieren?

false

-GroupID<Guid>

Specifies the GUID of specific package group.


Aliasse

none

Erforderlich?

true

Position?

1

Standardwert

none

Pipelineeingaben akzeptieren?

True (ByValue)

Platzhalterzeichen akzeptieren?

false

-Name<String>

Specifies the name of the package group.


Aliasse

none

Erforderlich?

true

Position?

1

Standardwert

none

Pipelineeingaben akzeptieren?

True (ByValue)

Platzhalterzeichen akzeptieren?

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.


Aliasse

none

Erforderlich?

false

Position?

named

Standardwert

none

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

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.


Aliasse

none

Erforderlich?

false

Position?

named

Standardwert

none

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-Version<Int32>

Specifies the version of the specified package group.


Aliasse

none

Erforderlich?

false

Position?

2

Standardwert

none

Pipelineeingaben akzeptieren?

True (ByValue)

Platzhalterzeichen akzeptieren?

false

-VersionID<Guid>

Specifies the version GUID of the package group.


Aliasse

none

Erforderlich?

false

Position?

2

Standardwert

none

Pipelineeingaben akzeptieren?

True (ByValue)

Platzhalterzeichen akzeptieren?

false

-Confirm

Sie werden vor dem Ausführen des Cmdlets zur Bestätigung aufgefordert.


Erforderlich?

false

Position?

named

Standardwert

falsch

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.


Erforderlich?

false

Position?

named

Standardwert

falsch

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

<CommonParameters>

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable. Weitere Informationen finden Sie unter about_CommonParameters (http://go.microsoft.com/fwlink/p/?LinkID=113216).

Eingaben

Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können.

  • AppvServer.AppvServerPackage, AppvServer.AppvServerConnectionGroup

Ausgaben

Der Ausgabetyp ist der Typ der Objekte, die vom Cmdlet ausgegeben werden.

  • AppvServer.AppvServerConnectionGroup

Hinweise

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

Beispiele

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")

Verwandte Themen

Anzeigen: