Added Delete-Profile script

Delete-Profile.ps1

@@ -0,0 +1,81 @@
+<#
+.SYNOPSIS
+  Deletes Profiles given a list of Profile IDs.
+.DESCRIPTION
+  Deletes Profiles given a list of Profile IDs. 
+.PARAMETER file 
+    Path of a CSV file with a list of Profile IDs.  This is required. 
+.PARAMETER fileColumn 
+    Column title in CSV file containing ProfileId values.  This is optional, with a default value of "ProfileId". 
+.INPUTS
+  AirWatchConfig.json
+  CSV File with headers
+.OUTPUTS
+  NO OUTPUT CURRENTLY:Outputs a CSV log of actions
+.NOTES
+  Version:        1.0
+  Author:         Joshua Clark @MrTechGadget
+  Creation Date:  01/09/2021
+  Update Date:    01/09/2021
+  Site:           https://github.com/MrTechGadget/aw-bulkdevices-script
+.EXAMPLE
+  Delete-Profile.ps1 -file .\ProfilesTest.csv -fileColumn "ProfileId"
+#>
+
+
+[CmdletBinding()] 
+Param(
+   [Parameter(Mandatory=$True,HelpMessage="Path to file listing ProfileId.")]
+   [string]$file,
+
+   [Parameter(HelpMessage="Name of Id column in file, default is ProfileId")]
+   [string]$fileColumn = "ProfileId"
+)
+
+Import-Module .\PSairwatch.psm1
+
+$Logfile = "$PSScriptRoot\ProfileDelete.log"
+
+Function Write-Log
+{
+    Param ([string]$logstring)
+
+    $logstring = ((Get-Date).ToString() + " - " + $logstring)
+    Add-content $Logfile -value $logstring
+}
+
+$list = Read-File $file $fileColumn
+
+Write-Log "$($MyInvocation.Line)"
+
+$decision = $Host.UI.PromptForChoice(
+    "Attention! If you proceed, " + $list.count + " profiles will be deleted from AirWatch",
+    "",
+    @('&Yes', '&No'), 1)
+
+if ($decision -eq 0) {
+    Write-Log "Deleting $($list.count) profiles from AirWatch"
+
+    foreach ($item in $list) {
+        Write-Progress -Activity "Deleting Profiles..." -Status "Profile $($list.IndexOf($item)+1) of $($list.Count)" -CurrentOperation "$item" -PercentComplete ((($list.IndexOf($list)+1)/($list.Count))*100)
+        $endpointURL = "mdm/profiles/${item}"
+        try {
+            $result = Send-Delete -endpoint $endpointURL -version "application/json;version=1"
+            if ($result -ne "") {
+                    Write-Warning ("Error Deleting Profile: $item : $result")
+                    Write-Log ("Error Deleting Profile: $item : $result")
+            } else {
+                Write-Host "$item Deleted $result"
+                Write-Log "$item Deleted $result"
+            }
+        }
+        catch {
+          $err2 = $Error[0].ErrorDetails.Message
+          Write-Warning "Error Sending Profile Delete Command: $item $err2"
+          Write-Log "Error Sending Profile Delete Command: $item $err2"
+        }
+    }
+} else {
+    Write-Host "Deletion Cancelled"
+    Write-Log "Deletion Cancelled"
+}

Get-DeviceDetails.ps1

@@ -7,8 +7,8 @@
     Path of a CSV file with a list of Serial Numbers and desired Asset Numbers.  This is required. 
 .PARAMETER fileColumn 
     Column title in CSV file containing SerialNumber values.  This is optional, with a default value of "SerialNumber". 
-.PARAMETER deviceColumn 
-    Column title in CSV file containing DeviceName values.  This is optional, with a default value of "DeviceName". 
+.PARAMETER searchBy 
+    Type of Id to search by.  This is optional, with a default value of "SerialNumber". 
 .INPUTS
   AirWatchConfig.json
   CSV File with headers

Get-Profiles.ps1 → Get-Profile.ps1

@@ -18,7 +18,7 @@
   Update Date:    01/09/2021
   Site:           https://github.com/MrTechGadget/aw-bulkdevices-script
 .EXAMPLE
-  .\Get-Profiles.ps1 -query "status=Active&platform=Apple"
+  .\Get-Profile.ps1 -query "status=Active&platform=Apple"
 #>
 
 

PSairwatch.psm1

@@ -339,7 +339,6 @@ Function Send-Get {
         Write-Warning "Error submitting Get. $($_.Exception.Message) "
         return $webReturn
     }
-
 }
 
 Function Send-Post {
@@ -362,7 +361,6 @@ Function Send-Post {
         Write-Warning "Error submitting POST. $($_.Exception.Message) "
         return $webReturn
     }
-
 }
 
 Function Send-Put {
@@ -385,7 +383,26 @@ Function Send-Put {
         Write-Warning "Error submitting PUT. $($_.Exception.Message) "
         return $webReturn
     }
+}
 
+Function Send-Delete {
+    Param(
+        [Parameter(Mandatory=$True,HelpMessage="Rest Endpoint for Delete, after https://airwatchServer/api/")]
+        [string]$endpoint,
+        [Parameter(HelpMessage="Version of API")]
+        [string]$version = $version1
+        )
+    $headers = Set-Header $restUserName $tenantAPIKey $version "application/json"
+    try {
+        $endpointURL = "https://${airwatchServer}/api/${endpoint}"
+        $webReturn = Invoke-RestMethod -Method Delete -Uri $endpointURL -Headers $headers
+
+        return $webReturn
+    }
+    catch {
+        Write-Warning "Error submitting Delete. $($_.Exception.Message) "
+        return $webReturn
+    }
 }
 
 Function Set-DeviceIdList {

README.md

@@ -43,15 +43,31 @@ EXAMPLE
 file parameter (REQUIRED) is the path to a CSV file with a list of Serial Numbers. fileColumn parameter (OPTIONAL, with a default value of "SerialNumber") is the Column title in CSV file containing SerialNumber values. 
 The user is prompted to confirm before it is executed. A progress bar shows progress through all of devices, and output to the window and a log file shows successes and failures of each device, as well as any errors.
 
+EXAMPLE
+  Reset-EnterpriseWipe.ps1 -file "Devices.csv" -fileColumn "SerialNumber"
+
 **Get-DeviceDetails.ps1** - Gets Device Details given a list of SerialNumbers and Desired names.
 file parameter (REQUIRED) is the path to a CSV file with a list of Serial Numbers. fileColumn parameter (OPTIONAL, with a default value of "SerialNumber") is the Column title in CSV file containing SerialNumber values. searchBy parameter (OPTIONAL, with a default value of "SerialNumber") is the type of identification number to use in search.
 
 EXAMPLE
-  Reset-EnterpriseWipe.ps1 -file "Devices.csv" -fileColumn "SerialNumber"
+  Get-DeviceDetails.ps1 -file "Devices.csv" -fileColumn "SerialNumber"
+
+**Get-Profile.ps1** - Gets Profiles with optional query parameters to limit results. 
+Optional query parameters to refine search. For values, refer to API documentation. https://as135.awmdm.com/api/help/#!/apis/10003?!/ProfilesV2/ProfilesV2_Search 
+Multiple parameters should be joined with "&"
+
+EXAMPLE
+  Get-Profiles.ps1 -query "status=Active&platform=Apple"
+
+**Delete-Profile.ps1** - Deletes Profiles given a list of Profile IDs. 
+file parameter (REQUIRED) is the path to a CSV file with a list of Profile IDs. 
+fileColumn parameter (OPTIONAL, with a default value of "ProfileId") is the Column title in CSV file containing ProfileId values.
+EXAMPLE
+  Delete-Profile.ps1 -file .\ProfilesTest.csv -fileColumn "ProfileId"
 
 ## Compatibility
 
-These PowerShell scripts are PowerShell Core (PS 6) compliant and were written with Visual Studio Code on a Mac. 
+These PowerShell scripts are PowerShell Core (PS 6+) compliant and were written with Visual Studio Code on a Mac. 
 
 They have been tested on Windows and Mac, but should also run on Linux.