Import-AppVManagementPackage¶
SYNOPSIS¶
Imports App-V Management packages into AppVentiX as publishing tasks.
SYNTAX¶
MatchWithMachineGroup (Default)¶
Import-AppVManagementPackage -MatchPackageWithMachineGroup [-SQLServer <string>]
[-SQLInstance <string>] [-SQLDatabase <string>] [-SQLCredential <pscredential>]
[-PublishingMachineGroupFriendlyName <string[]>] [-GUI] [-CachePackages]
[-UnassignedADGroup <string>] [-ThrottleLimit <int>] [-ConfigShare <string>] [<CommonParameters>]
MachineGroupName¶
Import-AppVManagementPackage -MachineGroupFriendlyName <string> [-SQLServer <string>]
[-SQLInstance <string>] [-SQLDatabase <string>] [-SQLCredential <pscredential>] [-CopyPackages]
[-RenamePackageFolder] [-Force] [-PublishingMachineGroupFriendlyName <string[]>] [-GUI]
[-CachePackages] [-UnassignedADGroup <string>] [-ThrottleLimit <int>] [-ConfigShare <string>]
[<CommonParameters>]
ALIASES¶
This cmdlet has the following aliases,
DESCRIPTION¶
Import-AppVManagementPackage retrieves packages from an App-V Management SQL database and converts them into AppVentiX publishing tasks. The function matches package URLs against the configured AppVentiX Content Stores and associates packages with a Machine Group, either matched automatically or specified. Packages without AD Groups in the App-V Management database are skipped (see -UnassignedADGroup). If a Deployment Configuration XML is present in the database, it is saved as an .appd file alongside the package. Packages can optionally be copied to the Content Store of a specific Machine Group (-CopyPackages).
EXAMPLES¶
EXAMPLE 1¶
Import-AppVManagementPackage
Imports all enabled App-V packages from the local SQL Server ('localhost', database 'AppVManagement') and publishes them to All Machine Groups.
EXAMPLE 2¶
Import-AppVManagementPackage -SQLServer 'sql01.domain.local' -SQLDatabase 'AppVManagement' -MatchPackageWithMachineGroup
Imports all enabled App-V packages from SQL Server 'sql01.domain.local' and associates each package with the corresponding AppVentiX Machine Group based on its Content Store location.
EXAMPLE 3¶
Import-AppVManagementPackage -SQLServer 'sql01.domain.local' -GUI -MatchPackageWithMachineGroup
Displays a selection window listing all available packages so the user can choose which ones to import, then associates them with the appropriate Machine Group.
EXAMPLE 4¶
Import-AppVManagementPackage -SQLServer 'sql01.domain.local' -MachineGroupFriendlyName 'VDI' -CopyPackages
Imports all enabled App-V packages from SQL Server 'sql01.domain.local', copies each .appv file to the Content Store of Machine Group 'VDI' and creates the publishing tasks for the copied packages. Packages that already exist in the Content Store are not overwritten unless -Force is specified.
EXAMPLE 5¶
Import-AppVManagementPackage -SQLServer 'sql01.domain.local' -MachineGroupFriendlyName 'VDI' -CopyPackages -RenamePackageFolder -Force
Imports all enabled App-V packages from SQL Server 'sql01.domain.local' and copies each .appv file to a folder
named after the file basename in the Content Store of Machine Group 'VDI', for example
'\fs01.domain.local\Source\WS12345\MSOffice365.appv' to '
PARAMETERS¶
-CachePackages¶
When specified, package manifest identity fields read from the Content Stores are cached in memory for the duration of the PowerShell session and reused on subsequent runs, so unchanged packages are not re-read. The cache is keyed on file path, last write time and size (a repackaged file is always re-read), is module-scoped, and is cleared when the module is reimported. Off by default.
Type: System.Management.Automation.SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
-ConfigShare¶
Internal parameter. Points to the AppVentiX configuration share path. Automatically populated from the module configuration and does not normally need to be specified manually.
Type: System.String
DefaultValue: $Script:AppVentiX.ConfigShare
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
-CopyPackages¶
Copies the .appv file of each package from its App-V Management location to the Content Store of the
Machine Group specified with -MachineGroupFriendlyName, using robocopy.
The folder structure below the
source share is kept.
The publishing task then points to the copied package.
If the package already exists
in the Content Store, a warning is shown and the existing file is used.
If the Machine Group has multiple Content Stores, the package is copied to the first Content Store of the
Machine Group.
Only the .appv file is copied.
The .appd and user configuration files are created from the App-V Management
database next to the copied package.
Example: '\fs01.domain.local\Source\WS12345\MSOffice365.appv' is copied to '
Type: System.Management.Automation.SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: MachineGroupName
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
-Force¶
Used with -CopyPackages. Overwrites a package that already exists in the Content Store. A warning is shown and the parameter is ignored when -CopyPackages is not specified.
Type: System.Management.Automation.SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: MachineGroupName
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
-GUI¶
When specified, displays a graphical selection window allowing the user to manually choose which packages to import.
Type: System.Management.Automation.SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
-MachineGroupFriendlyName¶
The friendly name of the AppVentiX Machine Group the packages are matched to. If not specified, packages are matched to All Machine Groups.
Type: System.String
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: MachineGroupName
Position: Named
IsRequired: true
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
-MatchPackageWithMachineGroup¶
When specified, attempts to match each package to the appropriate AppVentiX Machine Group based on its Content Store location. If no match is found, the package is published to all Machine Groups.
Type: System.Management.Automation.SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: MatchWithMachineGroup
Position: Named
IsRequired: true
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
-PublishingMachineGroupFriendlyName¶
The friendly name(s) of the AppVentiX Machine Group(s) to which the packages are published. If not specified, packages are published to the same Machine Group as matched by the Content Store location.
Type: System.String[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
-RenamePackageFolder¶
Used with -CopyPackages.
Copies the package to a folder in the Content Store root named after the .appv file
basename, instead of keeping the original folder structure.
Example: '\fs01.domain.local\Source\Apps\WS12345\MSOffice365.appv' is copied to '
Type: System.Management.Automation.SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: MachineGroupName
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
-SQLCredential¶
A PSCredential object for SQL Server authentication. Use [System.Management.Automation.PSCredential]::Empty for Windows authentication (default).
Type: System.Management.Automation.PSCredential
DefaultValue: '[System.Management.Automation.PSCredential]::Empty'
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
-SQLDatabase¶
The name of the App-V Management database. Default: 'AppVManagement'.
Type: System.String
DefaultValue: AppVManagement
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
-SQLInstance¶
The SQL Server instance name (optional). Leave empty for the default instance.
Type: System.String
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
-SQLServer¶
The name or IP address of the SQL Server hosting the App-V Management database. Default: 'localhost'.
Type: System.String
DefaultValue: localhost
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
-ThrottleLimit¶
The maximum number of package manifests to read concurrently from the Content Stores when retrieving AppVentiX Content Store packages. Reading manifests over a (usually remote) share is network-latency bound and benefits from parallelism. Default: 16. Increase on high-latency shares; decrease to reduce load on the file server.
Type: System.Int32
DefaultValue: 16
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
-UnassignedADGroup¶
The AD group, in 'domain.local\Group' format, used to entitle a package that has no AD Groups associated with it in the App-V Management database. Without this parameter, such packages are skipped. NOTE: Use the full domain name, not the NETBIOS name.
Type: System.String
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
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.