Win32App Migration Tool

Synopsis

The Win32 App Migration Tool is designed to inventory ConfigMgr Applications and Deployment Types, build .intunewin files and create Win3Apps in The MEM Admin Center.

Instead of manually checking Application and Deployment Type information and gathering content to build Win32apps, the Win32App Migration Tool is designed to do that for you. Currently, the Application and Deployment Type information is gathered and a .Intunewin file is created. We are also exporting the logo for the selected Application(s).

** The Win32App Migration Tool is still in BETA so I would welcome any feedback or suggestions for improvement. Reach out on Twitter to DM @byteben (DM's are open)**

Blog Post https://byteben.com/bb/automatically-migrate-applications-from-configmgr-to-intune-with-the-win32app-migration-tool/

Development Roadmap

After the BETA has been tested succesfully, the next stage of the project will be to build the Win32Apps in Intune automatically.

Requirements

Configuration Manager Console The console must be installed on the machine you are running the Win32App Migration Tool from. The following path should resolve true: $ENV:SMS_ADMIN_UI_PATH
Local Administrator The default Working folder is $ENV:SystemDrive\Win32AppMigrationTool. You will need permissions to create this directory on the System Drive
Roles Permission to run the Configuration Manager cmdlet Get-CMApplication
Content Folder Permission Read permissions to the content source for the Deployment Types that will be exported
PowerShell 5.1
Internet Access to download the Win32 Content Prep Tool

Getting Started

1. Install-Module Win32AppMigrationTool
2. New-Win32App -SiteCode "BB1" -ProviderMachineName "SCCM1.byteben.com" -AppName "Microsoft Edge Chromium *"
3. Use Information from the CSVs to build a Win32App in Intune

The current release of the Win32 App Migration Tool will do the following:-

Download the Win32app Content Prep Tool to %WorkingDirectory%\ContentPrepTool
Export .intunewin files to %WorkingDirectory%\Win32Apps<Application GUID><Deployment Type GUID>
Export Application Details to %WorkingDirectory%\Details\Applications.csv
Export Deployment Type Details to %WorkingDirectory%\Details\DeploymentTypes.csv
Export Content Details to %WorkingDirectory%\Details\Content.csv (If -DownloadContent parameter passed)
Copy Select Deployment Type Content to %WorkingDirectory%\Content<Deployment Type GUID>
Export Application Logo(s) to %WorkingDirectory%\Logos
Log events to %WorkingDirectory%\Logs\Main.log

Supported Install Commands

The Win32App Migration Tool will automatically detect the deployment technology based on the program install command for the Deployment Type. The following installers are supported:-

PowerShell Scripts
.EXE
.MSI
.CMD
.BAT
.VBS

Important Information

// Please use the tool with caution and test in your lab (dont be the guy or gal who tests in production). I accept no responsibility for loss or damage as a result of using these scripts //

Troubleshooting

Main.log in the %WorkingFolder%\Logs folder contains a detailed verbose output of the solution
Get-Help New-Win32App

Parameters

.Parameter AppName Pass an app name to search for matching applications in ConfigMgr. You can use * as a wildcard e.g. "Microsoft*" or "*Reader"

.Parameter SiteCode Specify the Sitecode you wish to connect to

.Parameter ProviderMachineName Specify the Site Server to connect to

.Parameter ExportLogo When passed, the Application logo is decoded from base64 and saved to the "Logos" folder

.Parameter DownloadContent When passed, the source content will be download to the local "Content" folder

.Parameter WorkingFolder This is the working folder for the Win32AppMigration Tool. Care should be given when specifying the working folder because downloaded content can increase the working folder size considerably. The Following folders are created in this directory:-

-Content
-ContentPrepTool
-Details
-Logos
-Logs
-Win32Apps

.Parameter PackageApps
Pass this parameter to package selected apps in the .intunewin format

.Parameter CreateApps
Pass this parameter to create the Win32apps in Intune

.Parameter ResetLog
Pass this parameter to reset the log file

.Parameter NoOGV
Pass this parameter supress the Out-GridView to select Applications. You can still pass wildcards to the -AppName parameter

.Parameter ExcludePMPC
Pass this parameter to exclude apps created by PMPC from the results. Filter is applied to Application "Comments". String can be modified in Get-AppList Function

.Parameter ExcludeFilter
Pass this parameter to exclude specific apps from the results. String value that accepts wildcards e.g. "Microsoft*"

Examples

.Example
New-Win32App -SiteCode "BB1" -ProviderMachineName "SCCM1.byteben.com" -AppName "Microsoft Edge Chromium *"

.Example
New-Win32App -SiteCode "BB1" -ProviderMachineName "SCCM1.byteben.com" -AppName "Microsoft Edge Chromium *" -DownloadContent

.Example
New-Win32App -SiteCode "BB1" -ProviderMachineName "SCCM1.byteben.com" -AppName "Microsoft Edge Chromium *" -ExportLogo

.Example
New-Win32App -SiteCode "BB1" -ProviderMachineName "SCCM1.byteben.com" -AppName "Microsoft Edge Chromium *" -ExportLogo -PackageApps

.Example
New-Win32App -SiteCode "BB1" -ProviderMachineName "SCCM1.byteben.com" -AppName "Microsoft Edge Chromium *" -ExportLogo -PackageApps -CreateApps

.Example
New-Win32App -SiteCode "BB1" -ProviderMachineName "SCCM1.byteben.com" -AppName "Microsoft Edge Chromium *" -ExportLogo -PackageApps -CreateApps -ResetLog

.Example
New-Win32App -SiteCode "BB1" -ProviderMachineName "SCCM1.byteben.com" -AppName "Microsoft Edge Chromium *" -ExportLogo -PackageApps -CreateApps -ResetLog -NoOGV

.Example
New-Win32App -SiteCode "BB1" -ProviderMachineName "SCCM1.byteben.com" -AppName "Microsoft Edge Chromium *" -ExportLogo -PackageApps -CreateApps -ResetLog -ExcludePMPC

.Example
New-Win32App -SiteCode "BB1" -ProviderMachineName "SCCM1.byteben.com" -AppName "Microsoft Edge Chromium " -ExportLogo -PackageApps -CreateApps -ResetLog -ExcludePMPC -ExcludeFilter "Microsoft"

Version History

Version 1.103.12.01 - 12/03/2022 - BETA

Added UTF8 Encoding for CSV Exports byteben#6
Added option to exclude PMPC apps byteben#5
Added option to exclude specific apps using a filter

Version 1.08.29.02 - 29/08/2021 - BETA

Fixed an issue where logos were not being exported
Fixed an issue where the Localized Display Name was not outputed correctly

Version 1.08.29.01 - 29/08/2021 - BETA

Default to not copy content locally.
Use -DownloadContent switch to copy content to local working folder
Fixed an issue when the source content folder has a space in the path

Version 1.03.27.02 - 27/03/2021 - BETA

Fixed a grammar issue when creating the Working Folders

Version 1.03.25.01 - 25/03/2021 - BETA

Removed duplicate name in message for successful .intunewin creation
Added a new switch "-NoOGV" which will suppress the Out-Grid view. Thanks @philschwan
Fixed an issue where the -ResetLog parameter was not working

Version 1.03.23.01 - 23/03/2021 - BETA

Error handling improved when connecting to the Site Server and passing a Null app name

Version 1.03.22.01 - 22/03/2021 - BETA

Updates Manifest to only export New-Win32App Function

Version 1.03.21.04 - 21/03/2021 - BETA

Fixed RootModule issue in psm1

Version 1.03.21.03 - 21/03/2021 - BETA

Fixed Function error for New-Win32App

Version 1.03.21.01 - 21/03/2021 - BETA

Added to PSGallery and converted to Module

Version 1.03.20.01 - 20/03/2021 - BETA

Added support for .vbs script installers
Fixed logic error for string matching

Version 1.03.19.01 - 19/03/2021 - BETA

Added Function Get-ScriptEnd

Version 1.03.18.03 - 18/03/2021 - BETA

Fixed an issue where Intunewin SetupFile was being detected as an .exe when msiexec was present in the install command

Version 1.03.18.02 - 18/03/2021 - BETA

Removed the character " from SetupFile command when an install command is wrapped in double quotes

Version 1.03.18.01 - 18/03/2021 - BETA

Robocopy for content now padding Source and Destination variables if content path has white space
Deployment Type Count was failing from the SDMPackageXML. Using the measure tool to check if Deployment Types exist for an Application
Removed " from SetupFile command if install commands are in double quotes

Version 1.03.18 - 18/03/2021 - BETA

Release for Testing
Logging Added

Version 1.0 - 14/03/2021 - DEV

DEV Release

Bugs

Git Issue "Package Multiple sources #4" STATUS: Investigating logic issue when uninstall content path differs from install path

Planned Improvements

~~Option to build .Intunewin files without downloading the Deployment Type content locally~~ Requires V1.8.29.1+
Gather Requirements, Detection Rules and Supercedence for Applications and Deployment Types
Create the Win32app in Intune
ConfigMgr Console Extension (Thanks @TheNotoriousDRR)
~~Add to PSGallery~~
~~Add support for .VBS~~
~~Convert to a Module~~