Merge pull request #12 from MrTechGadget/RebootDevice

Implemented Reboot Device script

Invoke-RebootDevice.ps1

@@ -0,0 +1,86 @@
+<#
+.SYNOPSIS
+  Reboots devices given a list of SerialNumbers.
+.DESCRIPTION
+  Reboots devices given a list of SerialNumbers. Uses the Command API to SoftReset (reboot) the device.
+.PARAMETER file 
+    Path of a CSV file with a list of Serial Numbers.  This is required. 
+.PARAMETER fileColumn 
+    Column title in CSV file containing SerialNumber values.  This is optional, with a default value of "SerialNumber". 
+.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:  09/30/2020
+  Update Date:    10/05/2020
+  Site:           https://github.com/MrTechGadget/aw-bulkdevices-script
+.EXAMPLE
+  .\Invoke-RebootDevice.ps1 -file "Devices.csv" -fileColumn "SerialNumber"
+#>
+
+
+[CmdletBinding()] 
+Param(
+  [Parameter(Mandatory = $True, Position = 0, ValueFromPipeline = $true, HelpMessage = "Path to file listing SerialNumbers.")]
+  [string]$file,
+
+  [Parameter(HelpMessage = "Name of Id column in file, default is SerialNumber")]
+  [string]$fileColumn = "SerialNumber"
+)
+
+Import-Module .\PSairwatch.psm1
+
+$Logfile = "$PSScriptRoot\RebootDevice.log"
+
+Function Write-Log {
+  Param ([string]$logstring)
+
+  $logstring = ((Get-Date).ToString() + " - " + $logstring)
+  Add-content $Logfile -value $logstring
+}
+
+$list = Read-FileWithData $file $fileColumn
+
+Write-Log "$($MyInvocation.Line)"
+
+$decision = $Host.UI.PromptForChoice(
+  "Attention! If you proceed, " + @($list).count + " devices will be rebooted",
+  "",
+  @('&Yes', '&No'), 1)
+
+if ($decision -eq 0) {
+  Write-Log "Rebooting $($list.count) devices in AirWatch"
+  $devices = @()
+  foreach ($item in $list) {
+    $devices += $item.$($fileColumn)
+  }
+  $json = Set-AddTagJSON $devices
+  Write-Progress -Activity "Rebooting Devices..." -Status "$($list.Count) devices" 
+  $endpointURL = "mdm/devices/commands/bulk?command=SoftReset&searchby=SerialNumber"
+  try {
+    $result = Send-Post -endpoint $endpointURL -body $json -version $version1
+    if ($result -eq "") {
+      $err = ($Error[0].ErrorDetails.Message | ConvertFrom-Json)
+      Write-Warning ("Error Rebooting Devices : Error", $err.errorCode, $err.message)
+      Write-Log ("Error Rebooting Devices : Error", $err.errorCode, $err.message)
+    }
+    else {
+      Write-Host "$result"
+      Write-Log "$result"
+    }
+  }
+  catch {
+    $err2 = ($Error[0].ErrorDetails.Message)
+    Write-Warning "Error Rebooting Devices $err2"
+    Write-Log "Error Rebooting Devices $err2"
+  }
+}
+else {
+  Write-Host "Action Cancelled"
+  Write-Log "Action Cancelled"
+}
+

README.md

@@ -25,6 +25,13 @@ Given this is a synchronous API call, the list is broken into batches of 50 per
 EXAMPLE
   Delete-User.ps1 -userFile "User.csv" -userFileColumn "Id.Value"
 
+**Invoke-RebootDevice.ps1** - Reboots devices given a list of SerialNumbers. Uses the Command API to SoftReset (reboot) the device.
+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. Output to the window and a log file shows successes and failures of devices, as well as any errors.
+
+EXAMPLE
+  Invoke-RebootDevice.ps1 -file "Devices.csv" -fileColumn "SerialNumber"
+
 **Reset-FullDevice.ps1** - This script executes a full device wipe for a CSV list of serial numbers. 
 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.