Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/psappdeploytoolkit/psappdeploytoolkit.tools

Companion module for PSAppDeployToolkit
https://github.com/psappdeploytoolkit/psappdeploytoolkit.tools

migration-tool powershell powershell-module psadt psappdeploytoolkit

Last synced: 22 days ago
JSON representation

Companion module for PSAppDeployToolkit

Awesome Lists containing this project

README

        

# ![PSAppDeployToolkit.Tools](https://github.com/user-attachments/assets/a275b3f9-6a45-42f0-a377-a57036d3f84d)

## Enterprise App Packaging, Extended.

PSAppDeployToolkit.Tools is a companion module for [PSAppDeployToolkit](https://github.com/PSAppDeployToolkit/PSAppDeployToolkit) that provides tools and functions useful during the application packaging process. Having this separate allows for a separate release schedule and also reduces the file size of the module that is required to be delivered to endpoints to handle software deployments.

### Features

- **Test-ADTCompatibility** - Test your PSAppDeployToolkit v3 scripts to get a full report on which functions and variables have changed in v4.
- **Convert-ADTDeployment** - Convert a PSAppDeployToolkit v3 script or an entire package folder to v4 standards.

## Getting Started

Install the module from the PowerShell Gallery:

```powershell
Install-Module PSAppDeployToolkit.Tools -Scope CurrentUser -AllowPreRelease
```

If this produces an error that the `-AllowPreRelease` parameter is not recognised, then first update PowerShellGet and then restart your PowerShell console:

```powershell
Install-Module PowerShellGet -Force -Scope CurrentUser
```

Alternatively you can import a downloaded copy of the module - however with this approach, you will need to ensure its pre-requisite modules **PSAppDeployToolkit** and **PSScriptAnalyzer** are available:

```powershell
Import-Module ""
```

Example command usage:

```powershell
Test-ADTCompatibility -FilePath .\Deploy-Application.ps1 -Format Grid
```

This example analyzes Deploy-Application.ps1 and outputs the results as a grid view.

```powershell
Convert-ADTDeployment -Path .\Deploy-Application.ps1
```

This example converts Deploy-Application.ps1 into Invoke-AppDeployToolkit.ps1 in the same folder.

```powershell
Convert-ADTDeployment -Path .\PackageFolder
```

This example converts PackageFolder into PackageFolder_Converted in the same folder.

### PSAppDeployToolkit Links

-> [Homepage](https://psappdeploytoolkit.com)
-> [Documentation](https://psappdeploytoolkit.com/docs)
-> [Function & Variable References](https://psappdeploytoolkit.com/docs/reference)
-> [Download Latest Release](https://github.com/PSAppDeployToolkit/PSAppDeployToolkit/releases)
-> [News](https://psappdeploytoolkit.com/blog)

### Community Links

-> [Discourse Forum](https://discourse.psappdeploytoolkit.com/)
-> [Discord Chat](https://discord.com/channels/618712310185197588/627204361545842688)
-> [Reddit](https://reddit.com/r/psadt)

## License

The PowerShell App Deployment Tool is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.