Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/byteben/Win32App-Migration-Tool

Last synced: 26 days ago
JSON representation

Host: GitHub
URL: https://github.com/byteben/Win32App-Migration-Tool
Owner: byteben
License: gpl-3.0
Created: 2021-03-19T13:27:27.000Z (over 3 years ago)
Default Branch: main
Last Pushed: 2024-04-04T16:34:54.000Z (3 months ago)
Last Synced: 2024-04-04T18:27:39.831Z (3 months ago)
Language: PowerShell
Size: 215 KB
Stars: 74
Watchers: 18
Forks: 15
Open Issues: 0
Metadata Files:
- Readme: README.md

Lists

jimsghstars - byteben/Win32App-Migration-Tool - (PowerShell)
awesome-stars - byteben/Win32App-Migration-Tool - (PowerShell)

README

# Win32App Migration Tool

![alt text](https://byteben.com/bb/Downloads/GitHub/Win32AppMigrationTool_10.jpg)

## Synopsis

The Win32 App Migration Tool is designed to inventory ConfigMgr Applications and Deployment Types, build .intunewin files and create Win3Apps in The Intune 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.

**Blog Post** https://msendpointmgr.com/2021/03/27/automatically-migrate-applications-from-configmgr-to-intune-with-the-win32app-migration-tool/

## Development Status

**STATUS: BETA**
The Win32App Migration Tool is still in BETA. I would welcome feedback or suggestions for improvement. Reach out on Twitter to DM @byteben (DM's are open)
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

## Quick Start

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

```
New-Win32App [-SiteCode] [[-ProviderMachineName] ] [[-AppName] ]
```

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\\
- 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\
- Export Application icons(s) to %WorkingDirectory%\Icons
- Log events to %WorkingDirectory%\Logs\Main.log

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

## Parameters

### -SiteCode

The Site Code of the ConfigMgr Site. he Site Code must be only 3 alphanumeric characters

```yaml
Type: String
Parameter Sets: (All)

Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Validate Pattern: ^[a-zA-Z0-9]{3}$')]
```

### -ProviderMachineName

Server name that has an SMS Provider site system role

```yaml
Type: String
Parameter Sets: (All)

Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Parameter AppName

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

```yaml
Type: String
Parameter Sets: (All)

Required: True
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
```

### -Parameter WorkingFolder

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

```yaml
Type: String
Parameter Sets: (All)

Required: False
Position: 3
Default value: C:\Win32AppMigrationTool
Accept pipeline input: False
Accept wildcard characters: False
```

### -Parameter ExcludeFilter

Pass this parameter to exclude specific apps from the results. Accepts wildcards e.g. "Microsoft*"'

```yaml
Type: String
Parameter Sets: (All)

Required: False
Position: 4
Default value:
Accept pipeline input: False
Accept wildcard characters: True
```

### -Parameter Win32ContentPrepToolUri

URI for Win32 Content Prep Tool

```yaml
Type: String
Parameter Sets: (All)

Required: False
Position: 5
Default value: https://github.com/microsoft/Microsoft-Win32-Content-Prep-Tool/raw/master/IntuneWinAppUtil.exe
Accept pipeline input: False
Accept wildcard characters: False
```

### -Parameter OverrideIntuneWin32FileName

Override intunewin filename. Default is the name calcualted from the install command line

```yaml
Type: String
Parameter Sets: (All)

Required: False
Position: 6
Default value:
Accept pipeline input: False
Accept wildcard characters: False
```

### -Parameter DownloadContent

DownloadContent: When passed, the content for the deployment type is saved locally to the working folder "Content"