Import-IvantiWCShortcut
Imports shortcuts from Ivanti Workspace Control XML configuration into AppVentiX.
Syntax
Import-IvantiWCShortcut
-XmlFilePath <String>
[-MachineGroupFriendlyName <String>]
[-GUI]
[<CommonParameters>]
Description
The Import-IvantiWCShortcut function extracts shortcut definitions from an Ivanti Workspace Control XML file and creates corresponding AppVentiX UserSetting XML files. It processes Active Directory group assignments and places imported items in the ‘Migrated User Settings’ folder.
The function optionally presents a GUI for selective import.
Parameters
-XmlFilePath
Path to the Ivanti Workspace Control XML configuration file.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MachineGroupFriendlyName
Friendly name of the machine group to assign the imported settings to.
| Type: | String |
| Position: | Named |
| Default value: | All Machine Groups |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-GUI
When specified, displays a graphical selection grid for interactive selection of which shortcuts to import.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Examples
Example 1: Import all shortcuts
Import-IvantiWCShortcut -XmlFilePath "C:\Config\IvantiBB.xml"
Imports all shortcuts from the Ivanti XML file into AppVentiX.
Example 2: Import with GUI selection and specific machine group
Import-IvantiWCShortcut -XmlFilePath "C:\Config\IvantiBB.xml" -MachineGroupFriendlyName "Production" -GUI
Opens a GUI for selective import and assigns shortcuts to the Production machine group.
Notes
- Requires a valid AppVentiX license
- User-type assignments are skipped; only group assignments are processed
- Imported settings are automatically placed in the ‘Migrated User Settings’ folder