Public/Get-AGMLibImageRange.ps1
|
Function Get-AGMLibImageRange([string]$appid,[string]$jobclass,[string]$appname,[string]$clusterid,[string]$appliancename,[string]$apptype,[string]$fuzzyappname,[string]$sltname,[datetime]$consistencydate,[int]$newerlimit,[int]$olderlimit,[switch][alias("h")]$hours,[switch][alias("o")]$onvault) { <# .SYNOPSIS Displays the range of images for an application or applications .EXAMPLE Get-AGMLibImageRange You will be prompted to supply either application ID, Appname or fuzzyappname. In addition or in place you can specify apptype If no newerlimit or olderlimit are specified then it defaults to -olderlimit 1 days If no consistencydate is specified todays date and time is assumed .EXAMPLE Get-AGMLibImageRange -appid 4771 Get all snapshot created in the last day for appid 4771 .EXAMPLE Get-AGMLibImageRange -appid 4771 -o Get all snapshot and OnVault images created in the last day for appid 4771 Only unique OnVault images will be shown, meaning if a snapshot and an OnVault image have the same consistencydate only the snapshot will be shown .EXAMPLE Get-AGMLibImageRange -appname smalldb Get all snapshot created in the last day for any app with app name smalldb .EXAMPLE Get-AGMLibImageRange -fuzzyappname smalldb Get all snapshot created in the last day for any app with an app name like smalldb .EXAMPLE Get-AGMLibImageRange -sltname Gold Get all snapshot created in the last day for any image with an SLT name like Gold .EXAMPLE Get-AGMLibImageRange -appid 4771 -appliancename "sa-hq" Get all snapshot created in the last day for appid 4771 on the appliance called sa-hq .EXAMPLE Get-AGMLibImageRange -appid 4771 -clusterid 1415038912 Get all snapshot created in the last day for appid 4771 on the appliance with the specified clusterid .EXAMPLE Get-AGMLibImageRange -appid 4771 -jobclass OnVault Get all OnVault created in the last day for appid 4771 .EXAMPLE Get-AGMLibImageRange -appid 4771 -olderlimit 4 -hours Get all snapshots created in the last four hours for appid 4771 .EXAMPLE Get-AGMLibImageRange -apptype VMBackup -olderlimit 2 Get all snapshots created in the last two days for any VMBackup .EXAMPLE Get-AGMLibImageRange -appid 4771 -olderlimit 4 -newerlimit 4 -consistencydate "2020-08-04 12:00" Get all snapshots created up to four days before or 4 days afer the date specified for the app specified .EXAMPLE Get-AGMLibImageRange -appid 4771 -olderlimit 4 -newerlimit 2 Get all snapshots created between 4 days ago (from olderlimit) and 2 days ago (from newerlimit, being 2 days newer than olderlimit) for the app specified. Note that if you make newerlimit greater than olderlimit you will be looking into the future, meaning you will get all images created from 4 days ago until now. .DESCRIPTION A function to find a range of images available for an application #> 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 ($appid) { $fv = "appid=$appid" } elseif ($appname) { $fv = "appname=" + $appname } elseif ($fuzzyappname) { $fv = "appname~" + $fuzzyappname } if ( (!($fv)) -and ($apptype) ) { $fv = "apptype=" + $apptype } elseif ( ($fv) -and ($apptype) ) { $fv = $fv + "&apptype=" + $apptype } # search for policyname if ( (!($fv)) -and ($policyname) ) { $fv = "policyname=" + $policyname } elseif ( ($fv) -and ($policyname) ) { $fv = $fv + "&policyname=" + $policyname } # search for sltname if ( (!($fv)) -and ($sltname) ) { $fv = "sltname=" + $sltname } elseif ( ($fv) -and ($sltname) ) { $fv = $fv + "&sltname=" + $sltname } if (!($fv)) { Get-AGMErrorMessage -messagetoprint "Please specify either appid, appname, fuzzyappname, sltname, policyname or apptype." return } # powershell is not case sensitive, but AGM jobclasses are, so this is a nice way to make sure the right case gets sent to AGM if ($jobclass -eq "onvault") { $jobclass = "OnVault" } if ($jobclass -eq "snapshot") { $jobclass = "snapshot" } if ($jobclass) { $fv = $fv + "&jobclass=$jobclass" } else { $fv = $fv + "&jobclass=snapshot" } # we offer two ways to ask for onvault, either -jobclass onVault or just -onvault or even -o if ($onvault) { $fv = $fv + "&jobclass=OnVault" } if ($appliancename) { $clusterid = (Get-AGMAppliance -filtervalue name=$appliancename).clusterid if (!($clusterid)) { Get-AGMErrorMessage -messagetoprint "Could not convert appliancename $appliancename into a clusterid." return } } if ($clusterid) { $fv = $fv + "&clusterid=$clusterid" } if ( (!($newerlimit)) -and (!($olderlimit)) ) { if (!($consistencydate)) { [datetime]$consistencydate = (Get-date).AddMinutes(1).ToString('yyyy-MM-dd HH:mm:ss') } if ($hours) { [datetime]$lowerrange = (Get-date).Addhours(-1).ToString('yyyy-MM-dd HH:mm:ss') } else { [datetime]$lowerrange = (Get-date).adddays(-1).ToString('yyyy-MM-dd HH:mm:ss') } $fv = $fv + "&consistencydate>$lowerrange" } elseif ( ($newerlimit) -and (!($olderlimit)) ) { if (!($consistencydate)) { Get-AGMErrorMessage -messagetoprint "A newerlimit was specified without a consistency date in the past to search forward from." return } $lowerrange = $consistencydate.ToString('yyyy-MM-dd HH:mm:ss') if ($hours) { [datetime]$upperrange = ($consistencydate).Addhours($newerlimit).ToString('yyyy-MM-dd HH:mm:ss') } else { [datetime]$upperrange = ($consistencydate).adddays($newerlimit).ToString('yyyy-MM-dd HH:mm:ss') } $fv = $fv + "&consistencydate>$lowerrange&consistencydate<$upperrange" } elseif ( (!($newerlimit)) -and ($olderlimit) ) { if (!($consistencydate)) { [datetime]$consistencydate = (Get-date).AddMinutes(1).ToString('yyyy-MM-dd HH:mm:ss') } $upperrange = $consistencydate.ToString('yyyy-MM-dd HH:mm:ss') if ($hours) { [datetime]$lowerrange = ($consistencydate).Addhours(-$olderlimit).ToString('yyyy-MM-dd HH:mm:ss') } else { [datetime]$lowerrange = ($consistencydate).adddays(-$olderlimit).ToString('yyyy-MM-dd HH:mm:ss') } $fv = $fv + "&consistencydate>$lowerrange&consistencydate<$upperrange" } else { if ($consistencydate) { if ($hours) { [datetime]$upperrange = ($consistencydate).Addhours($newerlimit).ToString('yyyy-MM-dd HH:mm:ss') [datetime]$lowerrange = ($consistencydate).Addhours(-$olderlimit).ToString('yyyy-MM-dd HH:mm:ss') } else { [datetime]$upperrange = ($consistencydate).adddays($newerlimit).ToString('yyyy-MM-dd HH:mm:ss') [datetime]$lowerrange = ($consistencydate).adddays(-$olderlimit).ToString('yyyy-MM-dd HH:mm:ss') } } else { if ($hours) { [datetime]$lowerrange = (Get-date).Addhours(-$olderlimit).ToString('yyyy-MM-dd HH:mm:ss') [datetime]$upperrange = ($lowerrange ).Addhours($newerlimit).ToString('yyyy-MM-dd HH:mm:ss') } else { [datetime]$lowerrange = (Get-date).adddays(-$olderlimit).ToString('yyyy-MM-dd HH:mm:ss') [datetime]$upperrange = ($lowerrange).adddays($newerlimit).ToString('yyyy-MM-dd HH:mm:ss') } } $fv = $fv + "&consistencydate>$lowerrange&consistencydate<$upperrange" } $output = Get-AGMImage -filtervalue "$fv" -sort ConsistencyDate:desc if ($output.id) { $AGMArray = @() Foreach ($id in $output) { $id | Add-Member -NotePropertyName appid -NotePropertyValue $id.application.id $id | Add-Member -NotePropertyName appliancename -NotePropertyValue $id.cluster.name $id | Add-Member -NotePropertyName hostname -NotePropertyValue $id.host.hostname $AGMArray += [pscustomobject]@{ apptype = $id.apptype hostname = $id.hostname appname = $id.appname appid = $id.appid appliancename = $id.appliancename jobclass = $id.jobclass jobclasscode = $id.jobclasscode backupname = $id.backupname id = $id.id consistencydate = $id.consistencydate endpit = $id.endpit } } if ($onvault) { $AGMArray | Select-Object apptype, appliancename, hostname, appname, appid, jobclass, jobclasscode, backupname, id, consistencydate, endpit | sort-object hostname,appname,consistencydate,jobclasscode } else { $AGMArray | Select-Object apptype, appliancename, hostname, appname, appid, jobclass, jobclasscode, backupname, id, consistencydate, endpit | sort-object hostname,appname,consistencydate } } else { $output } } |