Add Tag action from Tag scripts Repo (#31)

* Add import, refactor config

* Cleaned up description, added CmdletBinding

* Refactor read list of serials

* Added logging of tag action and  results

* Refactor POST API call

* Refactored Get and Select Tag

* Refactor Get-DeviceIds

* Cleaned up unused functions

* Remove Refactored function

PSairwatch.psm1

@@ -14,7 +14,7 @@
 .OUTPUTS
   None
 .NOTES
-  Version:        2.12.2
+  Version:        2.13.0
   Author:         Joshua Clark @MrTechGadget
   Source:         https://github.com/MrTechGadget/aw-bulkdevices-script
   Creation Date:  05/22/2018
@@ -287,6 +287,30 @@ Function Get-DeviceDetails {
 
 }
 
+Function Get-DeviceIds {
+    Param([string]$body)
+
+    Write-Verbose("------------------------------")
+    Write-Verbose("List of Serial Numbers")
+    Write-Verbose $body
+    Write-Verbose("------------------------------")
+
+    $headers = Set-Header $restUserName $tenantAPIKey $version1 "application/json"
+    $endpointURL = "https://${airwatchServer}/api/mdm/devices?searchby=Serialnumber"
+    $webReturn = Invoke-RestMethod -Method Post -Uri $endpointURL -Headers $headers -Body $body
+
+    $deviceids = @()
+    foreach ($serial in $webReturn.Devices) {
+        $deviceids += $serial.Id.Value
+    }
+    Write-Verbose("------------------------------")
+    Write-Verbose("List of Device IDs")
+    Write-Verbose "$($deviceIds)"
+    Write-Verbose("------------------------------")
+
+    return $deviceids
+}
+
 Function Get-TaggedDevice {
     Param([string]$SelectedTag)
 

Set-TagOnDevice.ps1

@@ -0,0 +1,81 @@
+
+<# Set-TagOnDevice Powershell Script Help
+  .SYNOPSIS
+    This Poweshell script adds a selected tag to a list of devices.
+  .DESCRIPTION
+    This script will take an input of serial numbers from a CSV file, converts them to device IDs. 
+    It queries a list of all Tags in the environment, the user selects the Tag to add the devices to and it adds the Tag in AirWatch for each of those devices.
+  .INPUTS
+    CSV File with headers
+  .OUTPUTS
+    NO OUTPUT CURRENTLY:Outputs a log of actions
+  .NOTES
+    Version:        1.4
+    Author:         Joshua Clark @MrTechGadget
+    Creation Date:  09/06/2017
+    Update Date:    10/25/2022
+    Site:           https://github.com/MrTechGadget/aw-bulkdevices-script
+  .EXAMPLE
+    .\Set-TagOnDevice.ps1 -file "Devices.csv" -fileColumn "SerialNumber"
+#>
+
+[CmdletBinding()] 
+Param(
+   [Parameter(Mandatory=$True,HelpMessage="Path to file listing SerialNumbers.")]
+   [string]$file,
+
+   [Parameter(HelpMessage="Name of Id column in file, default is SerialNumber")]
+   [string]$fileColumn = "SerialNumber"
+)
+
+Function Set-Action {
+    $options = [System.Management.Automation.Host.ChoiceDescription[]] @("&Add", "&Remove")
+    [int]$defaultchoice = 0
+    $opt = $host.UI.PromptForChoice($Title , $Info , $Options,$defaultchoice)
+    switch($opt)
+    {
+    0 { return "add"}
+    1 { return "remove"}
+    }
+}
+
+
+
+Import-Module .\PSairwatch.psm1
+Write-Log -logstring "$($MyInvocation.Line)"
+
+$Logfile = "$PSScriptRoot\TagActivity.log"
+
+<# 
+Start of Script
+#>
+
+$Config = Read-Config
+$tenantAPIKey = $Config.awtenantcode
+$organizationGroupID = $Config.groupid
+$airwatchServer = $Config.host
+$list = Read-File $file $fileColumn
+
+Write-Log -logstring "$($MyInvocation.Line)" -logfile $Logfile
+
+<# Get the tags, displays them to the user to select which tag to add. #>
+$TagList = Get-Tags
+$SelectedTag = Select-Tag $TagList
+$TagName = $TagList.keys | Where-Object {$TagList["$_"] -eq [string]$SelectedTag}
+Write-Host "Selected Tag: $($TagName)"
+Write-Log -logstring "Selected Tag: $($TagName)" -logfile $Logfile
+
+$action = Set-Action
+$SerialJSON = Set-AddTagJSON $list
+$deviceIds = Get-DeviceIds $SerialJSON
+$addTagJSON = Set-AddTagJSON $deviceIds
+$endpointURL = "mdm/tags/${SelectedTag}/${action}devices"
+$results = Send-Post $endpointURL $addTagJSON
+
+Write-Host("------------------------------")
+Write-Host("Results of ${action} Tags Call")
+Write-Host("Total Items: " +$results.TotalItems)
+Write-Host("Accepted Items: " + $results.AcceptedItems)
+Write-Host("Failed Items: " + $results.FailedItems)
+Write-Host("------------------------------")
+Write-Log -logstring "Results of ${action} Tags Call, Total Items: $($results.TotalItems), Accepted Items: $($results.AcceptedItems), Failed Items: $($results.FailedItems)" -logfile $Logfile