6.5 pre release

Author: stevevillardi

.gitignore

@@ -4,3 +4,4 @@ Dev.Logic.Monitor.psd1
 .DS_Store
 
 /.vscode
+Public/Test-LMDeviceRateLimit.ps1

Private/Test-LMSchedulaSchema.ps1

@@ -0,0 +1,62 @@
+function Test-LMScheduleSchema {
+    [CmdletBinding()]
+    param (
+        [Parameter(Mandatory)]
+        [PSCustomObject]$Schedule
+    )
+
+    # Required properties
+    $requiredProps = @('notify', 'type', 'recipients', 'cron', 'timezone')
+    
+    # Valid schedule types
+    $validTypes = @('manual', 'monthly', 'weekly', 'daily', 'hourly')
+    
+    # Validate all required properties exist
+    foreach ($prop in $requiredProps) {
+        if (-not $Schedule.PSObject.Properties.Name.Contains($prop)) {
+            throw "Schedule object is missing required property: $prop"
+        }
+    }
+
+    # Validate property types
+    if ($Schedule.notify -isnot [bool]) {
+        throw "notify must be a boolean value"
+    }
+    
+    if ($Schedule.type -isnot [string] -or $validTypes -notcontains $Schedule.type) {
+        throw "type must be one of: $($validTypes -join ', ')"
+    }
+    
+    if ($Schedule.recipients -isnot [array]) {
+        throw "recipients must be an array"
+    }
+    
+    if ($Schedule.cron -isnot [string]) {
+        throw "cron must be a string"
+    }
+    
+    if ($Schedule.timezone -isnot [string]) {
+        throw "timezone must be a string"
+    }
+
+    # If recipients are provided, validate they are email addresses
+    if ($Schedule.recipients.Count -gt 0) {
+        $emailRegex = "^[\w-\.]+@([\w-]+\.)+[\w-]{2,4}$"
+        foreach ($recipient in $Schedule.recipients) {
+            if ($recipient -notmatch $emailRegex) {
+                throw "Invalid email address format: $recipient"
+            }
+        }
+    }
+
+    # Validate cron format based on type
+    switch ($Schedule.type) {
+        'monthly' { if ($Schedule.cron -notmatch '^\d{2}\s\d{2}\s\*\s\d{1,2}\s\d{1,2}$') { throw "Invalid monthly cron format" } }
+        'weekly'  { if ($Schedule.cron -notmatch '^\d{2}\s\d{2}\s\*\s\*\s\d{1}$') { throw "Invalid weekly cron format" } }
+        'daily'   { if ($Schedule.cron -notmatch '^\d{2}\s\d{2}\s\*\s\*\s\*$') { throw "Invalid daily cron format" } }
+        'hourly'  { if ($Schedule.cron -notmatch '^\d{2}\s\*\s\*\s\*\s\*$') { throw "Invalid hourly cron format" } }
+        'manual'  { if ($Schedule.cron -ne '') { throw "Cron should be empty for manual type" } }
+    }
+
+    Write-Information "Supplied schedule, meets schema requirements."
+}

Public/Connect-LMAccount.ps1

@@ -240,7 +240,7 @@ Function Connect-LMAccount {
         Valid       = $true
         Type        = $Type
     }
-    
+
     #Check for newer version of Logic.Monitor module
     Try {
         If ($AutoUpdateModuleVersion -and !$SkipVersionCheck) {

Public/Copy-LMDashboard.ps1

@@ -17,6 +17,9 @@ The name of the dashboard to be copied. This parameter is mandatory when using t
 .PARAMETER Description
 An optional description for the new dashboard.
 
+.PARAMETER DashboardTokens
+A hashtable of tokens to be replaced in the dashboard. The key is the token name and the value is the new value. If not provided, the tokens from the source dashboard will be used.
+
 .PARAMETER ParentGroupId
 The ID of the parent group for the new dashboard. This parameter is mandatory when using the 'GroupId-Id' or 'GroupId-Name' parameter sets.
 
@@ -31,6 +34,10 @@ Copies the dashboard with ID 12345 to a new dashboard named "New Dashboard" in t
 Copy-LMDashboard -Name "New Dashboard" -DashboardName "Old Dashboard" -ParentGroupName "Group A"
 Copies the dashboard named "Old Dashboard" to a new dashboard named "New Dashboard" in the group named "Group A".
 
+.EXAMPLE
+Copy-LMDashboard -Name "New Dashboard" -DashboardName "Old Dashboard" -ParentGroupName "Group A" -DashboardTokens @{ "defaultResourceName" = "Value1"; "defaultResourceGroup" = "Value2" }
+Copies the dashboard named "Old Dashboard" to a new dashboard named "New Dashboard" in the group named "Group A", replacing the tokens "defaultResourceName" with "Value1" and "defaultResourceGroup" with "Value2".
+
 .NOTES
 Ensure that you are logged in before running any commands by using the Connect-LMAccount cmdlet.
 #>
@@ -51,6 +58,8 @@ Function Copy-LMDashboard {
 
         [String]$Description,
 
+        [Hashtable]$DashboardTokens,
+
         [Parameter(Mandatory, ParameterSetName = 'GroupId-Id')]
         [Parameter(Mandatory, ParameterSetName = 'GroupId-Name')]
         [Int]$ParentGroupId,
@@ -86,6 +95,24 @@ Function Copy-LMDashboard {
 
         #Get existing dashboard config
         $SourceDashboard = Get-LMDashboard -Id $DashboardId
+
+        #Replace tokens
+        If ($DashboardTokens) {
+            $WidgetTokens = New-Object -TypeName System.Collections.ArrayList
+            
+            #Build widget tokens
+            $DashboardTokens.GetEnumerator() | ForEach-Object {
+                $WidgetTokens.Add( [PSCustomObject]@{
+                        type = "owned"
+                        name  = $_.Key
+                        value = $_.Value
+                        inheritList = @()
+                    }
+                ) | Out-Null
+            }
+            #Replace widget tokens
+            $SourceDashboard.widgetTokens = $WidgetTokens
+        }
 
         #Build header and uri
         $ResourcePath = "/dashboard/dashboards/$DashboardId/clone"
@@ -101,7 +128,7 @@ Function Copy-LMDashboard {
                 sharable      = $SourceDashboard.sharable
             }
 
-            $Data = ($Data | ConvertTo-Json)
+            $Data = ($Data | ConvertTo-Json -Depth 10)
 
             $Headers = New-LMHeader -Auth $Script:LMAuth -Method "POST" -ResourcePath $ResourcePath -Data $Data 
             $Uri = "https://$($Script:LMAuth.Portal).logicmonitor.com/santaba/rest" + $ResourcePath

Public/Copy-LMReport.ps1

@@ -19,11 +19,10 @@ The description of the report.
 The ID of the parent group.
 
 .PARAMETER ReportObject
-The report object to be copied.
+The report object to be copied. This can be retrieved using Get-LMReport. Any changes to the report object will be reflected in the new report.
 
 .EXAMPLE
 Copy-LMReport -Name "Report1" -Description "This is a sample report" -ParentGroupId "12345" -ReportObject $reportObject
-
 This example copies the report specified by the ReportObject parameter and sets the name, description, and parent group ID.
 
 .NOTES

Public/Get-LMDevice.ps1

@@ -117,8 +117,6 @@ Function Get-LMDevice {
                 $Headers = New-LMHeader -Auth $Script:LMAuth -Method "GET" -ResourcePath $ResourcePath
                 $Uri = "https://$($Script:LMAuth.Portal).logicmonitor.com/santaba/rest" + $ResourcePath + $QueryParams
 
-                
-                
                 Resolve-LMDebugInfo -Url $Uri -Headers $Headers[0] -Command $MyInvocation
 
                 #Issue request

Public/New-LMNetscan.ps1

@@ -74,6 +74,8 @@ Function New-LMNetScan {
 
         [String]$NetScanGroupId = "1",
 
+        [PSCustomObject]$Schedule,
+
         [Parameter(Mandatory)]
         [String]$SubnetRange,
 
@@ -123,12 +125,16 @@ Function New-LMNetScan {
                 value           = "21,22,23,25,53,69,80,81,110,123,135,143,389,443,445,631,993,1433,1521,3306,3389,5432,5672,6081,7199,8000,8080,8081,9100,10000,11211,27017"
             }
 
-            $Schedule = @{
-                cron       = ""
-                notify     = $false
-                recipients = @()
-                timezone   = "America/New_York"
-                type       = "manual"
+            If(!$Schedule){
+                $Schedule = @{
+                    cron       = ""
+                    notify     = $false
+                    recipients = @()
+                    timezone   = "America/New_York"
+                    type       = "manual"
+                }
+            } Else {
+                Test-LMScheduleSchema -Schedule $Schedule
             }
 
             Try {

Public/Set-LMNetScan.ps1

@@ -30,6 +30,8 @@ Function Set-LMNetscan {
 
         [String]$CredentialGroupName,
 
+        [PSCustomObject]$Schedule,
+
         [String]$ChangeNameToken,
 
         [String]$PortList
@@ -86,8 +88,6 @@ Function Set-LMNetscan {
                 }
             }
 
-            $Schedule = $null
-
             Try {
                 $Data = @{
                     id                        = $Id
@@ -104,7 +104,7 @@ Function Set-LMNetscan {
                     ddr                       = $DDR
                     credentials               = $Creds
                     ports                     = $Ports
-                    schedule                  = $Schedule
+                    schedule                  = If($Schedule){$Schedule}Else{$null}
                 }