Development (#1)

* save commit

* Initial release; v1.0.0

---------

Co-authored-by: Andy Lievertz <[email protected]>

Author: alievertz

CHANGELOG.md

@@ -0,0 +1,5 @@
+# OZO Remove AppX Packages
+
+|Date|Version|Comment|
+|----|-------|-------|
+|2025-Feb-15|1.0.0|Initial release.|

PowerShell-Remove-AppX-Packages.ps1

@@ -1 +1,34 @@
-# powershell-remove-appx-packages
+# OZO Remove AppX Packages
+
+## Description
+Removes provisioned AppX packages for the current user and available AppX packages from the running system. You can generate a list of your system's available AppX packages with the following in an _Administrator_ PowerShell:
+```powershell
+(Get-AppxPackage).Name
+```
+
+## Installation
+This script is published to the [PowerShell Gallery](https://learn.microsoft.com/en-us/powershell/scripting/gallery/overview?view=powershell-5.1). Ensure your system is configured for this repository then execute the following in an _Administrator_ PowerShell:
+
+```powershell
+Install-Script ozo-remove-appx-packages
+```
+
+## Usage
+Run this script in an _Admininstrator_ PowerShell.
+```powershell
+ozo-remove-appx-packages
+    -Packages <Array>
+```
+
+## Parameters
+|Parameter|Description|
+|---------|-----------|
+|`Packages`|A comma-separated list of packages to remove.|
+
+## Example
+```powershell
+ozo-remove-appx-packages -Packages "Microsoft.BingWeather","Microsoft.SkypeApp","Microsoft.ZuneMusic"
+```
+
+## Acknowledgements
+Special thanks to my employer, [Sonic Healthcare USA](https://sonichealthcareusa.com), who has supported the growth of my PowerShell skillset and enabled me to contribute portions of my work product to the PowerShell community.

README.md

@@ -0,0 +1,78 @@
+#Requires -Modules @{ModuleName="OZO";ModuleVersion="1.4.0"},@{ModuleName="OZOLogger";ModuleVersion="1.1.0"} -RunAsAdministrator
+
+<#PSScriptInfo
+    .VERSION 1.0.0
+    .GUID 26313204-248b-4816-89de-4c605134b2ca
+    .AUTHOR Andy Lievetz <[email protected]>
+    .COMPANYNAME One Zero One
+    .COPYRIGHT This script is released under the terms of the GNU General Public License ("GPL") version 2.0.
+    .TAGS 
+    .LICENSEURI https://github.com/onezeroone-dev/OZO-Remove-AppX-Packages/blob/main/LICENSE
+    .PROJECTURI https://github.com/onezeroone-dev/OZO-Remove-AppX-Packages
+    .ICONURI 
+    .EXTERNALMODULEDEPENDENCIES 
+    .REQUIREDSCRIPTS 
+    .EXTERNALSCRIPTDEPENDENCIES 
+    .RELEASENOTES https://github.com/onezeroone-dev/OZO-Remove-AppX-Packages/blob/main/CHANGELOG.md
+#>
+
+<# 
+    .DESCRIPTION 
+    Removes provisioned AppX packages for the current user and available AppX packages from the running system.
+    .PARAMETER Packages
+    A comma-separated list of packages to remove.
+    .LINK
+    https://github.com/onezeroone-dev/OZO-Remove-AppX-Packages/blob/main/README.md
+    .NOTES
+    Run this script in an Administrator PowerShell.
+#>
+[CmdLetBinding(SupportsShouldProcess=$true)]
+Param(
+    [Parameter(Mandatory=$true,HelpMessage="A comma-separated list of packages to remove")][Array] $Packages
+)
+
+Function Get-OZOUserInteractive {
+    return [Environment]::UserInteractive
+}
+
+# MAIN
+# Variables
+[Array] $AppxPackages            = (Get-AppxPackage)
+[Array] $AppxProvisionedPackages = (Get-AppxProvisionedPackage -Online)
+# Determine if the session is user-interactive
+If ((Get-OZOUserInteractive) -eq $true) {
+    # Session is user-interactive; iterate through the list of packages
+    ForEach ($Package in $Packages) {
+        Write-Host ("Processing available Appx packages.")
+        # Determine if the AppxPackages array contains the package
+        If (($AppxPackages).Name -Contains $Package) {
+            # The array contains the package; remove it
+            Try {
+                Remove-AppxPackage -Package ($AppxPackages | Where-Object {$_.Name -eq $Package}).PackageFullName -ErrorAction Stop
+                # Success
+                Write-Host ("Removed the " + $Package + " available package.")
+            } Catch {
+                # Failure
+                Write-Host ("Error removing the " + $Package + "available package. Error message is: " + $_)
+            }
+        } Else {
+            Write-Host ("Did not find " + $Package + " among the available Appx packages.")
+        }
+        Write-Host ("Processing provisioned Appx packages.")
+        # Determine if the AppxProvisionedPackages array contains the package
+        If (($AppxProvisionedPackages).DisplayName -Contains $Package) {
+            # The array contains the package; remove it
+            Try {
+                Remove-AppxProvisionedPackage -Online -PackageName ($AppxProvisionedPackages | Where-Object {$_.DisplayName -eq $Package}).PackageName | Out-Null
+                Write-Host ("Removed the " + $Package + " provisioned package.")
+            } Catch {
+                Write-Host ("Error removing the " + $Package + "provisioned package. Error message is: " + $_)
+            }
+        } Else {
+            Write-Host ("Did not find " + $Package + " among the provisioned Appx packages.")
+        }
+    }
+} Else {
+    # Session is not user-interactive
+    Write-OZOProvider -Message "Please run this script in a user-interactive session." -Level "Error"
+}