Public/Set-AGMLibImage.ps1
|
Function Set-AGMLibImage ([array]$imagelist,$filename,[string]$imagename,[string]$label) { <# .SYNOPSIS Sets the label for an image or a range of images using either an array of images or a CSV file .EXAMPLE Set-AGMLibImage -imagename Image_1234 -label "ConfirmedGood" Set the label for the image with imagename Image_1234 .EXAMPLE Set-AGMLibImage -imagelist $imagelist .DESCRIPTION We can create an imagelist several ways. This method literally gets every image $imagelist = Get-AGMImage | select id,backupname,label We could update the label field like this: foreach ($image in $imagelist) { $image.label = "Needs Checking" } Then run the command: Set-AGMLibImage -imagelist $imagelist We could then export like this: $imagelist | Export-Csv -Path images.csv Then edit the file and when reading save the CSV and run this command: Set-AGMLibImage -filename images.csv Another way to create the image list is with: New-AGMLibImageRange #> if ( (!($AGMSESSIONID)) -or (!($AGMIP)) ) { Get-AGMErrorMessage -messagetoprint "Not logged in or session expired. Please login using Connect-AGM" return } else { $sessiontest = (Get-AGMSession).session_id if ($sessiontest -ne $AGMSESSIONID) { Get-AGMErrorMessage -messagetoprint "Not logged in or session expired. Please login using Connect-AGM" return } } if ((!($imagelist)) -and (!($filename)) -and (!($imagename))) { Write-host "This function is used to label a large number of images in a single command. This is done by supplying one of the following: -- A list of images to label, normally created with New-AGMLibImageRange. We then use -imagelist <imagelist> -- A CSV file contained a list of images with new labels. The file needs to have at least id,backupname,label as headings. You could use New-AGMLibImageRange to create this file. Then use: -filename <filename.csv> -- An imagename. You could learn this in the AGM Web GUI. Then use: -imagename <imagename> -label <newlabel>" } if ($filename) { if ([IO.File]::Exists($filename)) { $imagelist = Import-Csv -Path $filename } } if ($imagelist) { if ((!($imagelist.id)) -or (!($imagelist.label)) -or (!($imagelist.backupname))) { Get-AGMErrorMessage -messagetoprint "The imagelist specified with -imagelist needs to contain the following fields: id, backupname, label" return } } if ($imagename) { if (!($label)) { [string]$label = Read-host "Label" } Set-AGMImage -imagename $imagename -label $label } else { foreach ($image in $imagelist | where-object {$_.label.length -gt 0}) { Set-AGMImage -id $image.id -label $image.label -imagename $image.backupname } } } |