7.9.2 release

stevevillardi · stevevillardi · commit 04646efa0a78 · 2026-03-06T15:01:52.000-05:00
diff --git a/Documentation/New-LMDeviceDatasourceInstanceSDT.md b/Documentation/New-LMDeviceDatasourceInstanceSDT.md
@@ -112,7 +112,10 @@ Accept wildcard characters: False
 ```
 
 ### -Timezone
-Specifies the IANA timezone for SDTs.
+Specifies the timezone for SDTs.
+Accepts IANA timezone IDs (e.g.
+America/New_York), Windows standard names (e.g.
+Eastern Standard Time), or the output of (Get-TimeZone).StandardName.
 If omitted, the portal timezone is used.
 
 ```yaml
diff --git a/Documentation/New-LMDeviceDatasourceSDT.md b/Documentation/New-LMDeviceDatasourceSDT.md
@@ -127,7 +127,10 @@ Accept wildcard characters: False
 ```
 
 ### -Timezone
-Specifies the IANA timezone for SDTs.
+Specifies the timezone for SDTs.
+Accepts IANA timezone IDs (e.g.
+America/New_York), Windows standard names (e.g.
+Eastern Standard Time), or the output of (Get-TimeZone).StandardName.
 If omitted, the portal timezone is used.
 
 ```yaml
diff --git a/Documentation/New-LMDeviceGroupSDT.md b/Documentation/New-LMDeviceGroupSDT.md
@@ -143,7 +143,10 @@ Accept wildcard characters: False
 ```
 
 ### -Timezone
-Specifies the IANA timezone for SDTs.
+Specifies the timezone for SDTs.
+Accepts IANA timezone IDs (e.g.
+America/New_York), Windows standard names (e.g.
+Eastern Standard Time), or the output of (Get-TimeZone).StandardName.
 If omitted, the portal timezone is used.
 
 ```yaml
diff --git a/Documentation/New-LMDeviceSDT.md b/Documentation/New-LMDeviceSDT.md
@@ -92,6 +92,18 @@ New-LMDeviceSDT -Comment "Maintenance window" -StartDate "2022-01-01 00:00:00" -
 Creates a one-time SDT for the device with ID "12345".
 ```
 
+### EXAMPLE 2
+```
+New-LMDeviceSDT -Comment "Maintenance window" -StartDate (Get-Date).AddHours(1) -EndDate (Get-Date).AddHours(3) -DeviceName "server01" -Timezone "Eastern Standard Time"
+Creates a one-time SDT using a Windows standard timezone name.
+```
+
+### EXAMPLE 3
+```
+New-LMDeviceSDT -Comment "Maintenance window" -StartDate (Get-Date).AddHours(1) -EndDate (Get-Date).AddHours(3) -DeviceName "server01" -Timezone (Get-TimeZone).StandardName
+Creates a one-time SDT using the local machine's timezone via Get-TimeZone.
+```
+
 ## PARAMETERS
 
 ### -Comment
@@ -142,7 +154,10 @@ Accept wildcard characters: False
 ```
 
 ### -Timezone
-Specifies the IANA timezone for SDTs.
+Specifies the timezone for SDTs.
+Accepts IANA timezone IDs (e.g.
+America/New_York), Windows standard names (e.g.
+Eastern Standard Time), or the output of (Get-TimeZone).StandardName.
 If omitted, the portal timezone is used.
 
 ```yaml
diff --git a/Documentation/Set-LMSDT.md b/Documentation/Set-LMSDT.md
@@ -99,7 +99,10 @@ Accept wildcard characters: False
 ```
 
 ### -Timezone
-Specifies the IANA timezone for SDTs.
+Specifies the timezone for SDTs.
+Accepts IANA timezone IDs (e.g.
+America/New_York), Windows standard names (e.g.
+Eastern Standard Time), or the output of (Get-TimeZone).StandardName.
 For one-time date conversion, if omitted, the portal timezone is used.
 
 ```yaml
diff --git a/Private/ConvertTo-LMSDTEpochMillis.ps1 b/Private/ConvertTo-LMSDTEpochMillis.ps1
diff --git a/Public/New-LMDeviceDatasourceInstanceSDT.ps1 b/Public/New-LMDeviceDatasourceInstanceSDT.ps1
@@ -15,7 +15,7 @@ Specifies the start date for the new instance SDT. This parameter is mandatory w
 Specifies the end date for the new instance SDT. This parameter is mandatory when using the 'OneTime' parameter set.
 
 .PARAMETER Timezone
-Specifies the IANA timezone for SDTs. If omitted, the portal timezone is used.
+Specifies the timezone for SDTs. Accepts IANA timezone IDs (e.g. America/New_York), Windows standard names (e.g. Eastern Standard Time), or the output of (Get-TimeZone).StandardName. If omitted, the portal timezone is used.
 
 .PARAMETER StartHour
 Specifies the start hour for the new instance SDT. This parameter is mandatory when using the 'Daily', 'Monthly', 'MonthlyByWeek', or 'Weekly' parameter sets. The value must be between 0 and 23.
diff --git a/Public/New-LMDeviceDatasourceSDT.ps1 b/Public/New-LMDeviceDatasourceSDT.ps1
@@ -15,7 +15,7 @@ The start date for the SDT. This parameter is mandatory when using the 'OneTime'
 The end date for the SDT. This parameter is mandatory when using the 'OneTime' parameter set.
 
 .PARAMETER Timezone
-Specifies the IANA timezone for SDTs. If omitted, the portal timezone is used.
+Specifies the timezone for SDTs. Accepts IANA timezone IDs (e.g. America/New_York), Windows standard names (e.g. Eastern Standard Time), or the output of (Get-TimeZone).StandardName. If omitted, the portal timezone is used.
 
 .PARAMETER StartHour
 The start hour for the SDT. This parameter is mandatory when using the 'Daily', 'Monthly', 'MonthlyByWeek', or 'Weekly' parameter sets. Must be a value between 0 and 23.
diff --git a/Public/New-LMDeviceGroupSDT.ps1 b/Public/New-LMDeviceGroupSDT.ps1
@@ -15,7 +15,7 @@ Specifies the start date and time for the scheduled downtime. This parameter is
 Specifies the end date and time for the scheduled downtime. This parameter is mandatory when using the 'OneTime-DeviceGroupId' or 'OneTime-DeviceGroupName' parameter sets.
 
 .PARAMETER Timezone
-Specifies the IANA timezone for SDTs. If omitted, the portal timezone is used.
+Specifies the timezone for SDTs. Accepts IANA timezone IDs (e.g. America/New_York), Windows standard names (e.g. Eastern Standard Time), or the output of (Get-TimeZone).StandardName. If omitted, the portal timezone is used.
 
 .PARAMETER StartHour
 Specifies the start hour for the scheduled downtime. This parameter is mandatory when using recurring parameter sets. The value must be between 0 and 23.
diff --git a/Public/New-LMDeviceSDT.ps1 b/Public/New-LMDeviceSDT.ps1
@@ -15,7 +15,7 @@ Specifies the start date and time for the SDT. This parameter is mandatory when
 Specifies the end date and time for the SDT. This parameter is mandatory when using the 'OneTime-DeviceId' or 'OneTime-DeviceName' parameter sets.
 
 .PARAMETER Timezone
-Specifies the IANA timezone for SDTs. If omitted, the portal timezone is used.
+Specifies the timezone for SDTs. Accepts IANA timezone IDs (e.g. America/New_York), Windows standard names (e.g. Eastern Standard Time), or the output of (Get-TimeZone).StandardName. If omitted, the portal timezone is used.
 
 .PARAMETER StartHour
 Specifies the start hour for recurring SDTs. This parameter is mandatory when using recurring parameter sets. Must be between 0 and 23.
@@ -48,6 +48,14 @@ Specifies the name of the device. This parameter is mandatory when using name-ba
 New-LMDeviceSDT -Comment "Maintenance window" -StartDate "2022-01-01 00:00:00" -EndDate "2022-01-01 06:00:00" -DeviceId "12345"
 Creates a one-time SDT for the device with ID "12345".
 
+.EXAMPLE
+New-LMDeviceSDT -Comment "Maintenance window" -StartDate (Get-Date).AddHours(1) -EndDate (Get-Date).AddHours(3) -DeviceName "server01" -Timezone "Eastern Standard Time"
+Creates a one-time SDT using a Windows standard timezone name.
+
+.EXAMPLE
+New-LMDeviceSDT -Comment "Maintenance window" -StartDate (Get-Date).AddHours(1) -EndDate (Get-Date).AddHours(3) -DeviceName "server01" -Timezone (Get-TimeZone).StandardName
+Creates a one-time SDT using the local machine's timezone via Get-TimeZone.
+
 .NOTES
 You must run Connect-LMAccount before running this command.
 
diff --git a/Public/Set-LMSDT.ps1 b/Public/Set-LMSDT.ps1
@@ -18,7 +18,7 @@ Specifies the start date and time for one-time SDT.
 Specifies the end date and time for one-time SDT.
 
 .PARAMETER Timezone
-Specifies the IANA timezone for SDTs. For one-time date conversion, if omitted, the portal timezone is used.
+Specifies the timezone for SDTs. Accepts IANA timezone IDs (e.g. America/New_York), Windows standard names (e.g. Eastern Standard Time), or the output of (Get-TimeZone).StandardName. For one-time date conversion, if omitted, the portal timezone is used.
 
 .PARAMETER StartHour
 Specifies the start hour (0-23) for recurring SDT.
diff --git a/README.md b/README.md
@@ -72,6 +72,10 @@ Connect-LMAccount -UseCachedCredential
 ```
 
 # Change List
+## 7.9.2
+### Bug Fixes
+- **SDT timezone compatibility with PowerShell 5.1**: Fixed an issue introduced in v7.9.1 where SDT commands would fail on PowerShell 5.1 with `Invalid timezone` errors due to .NET Framework not supporting IANA timezone IDs (e.g. `America/New_York`) directly.
+- **Cross-platform timezone support**: SDT commands now accept both IANA timezone IDs (e.g. `America/New_York`) and Windows standard timezone names (e.g. `Eastern Standard Time`). The module automatically resolves the input to the correct format for the API regardless of PowerShell version or operating system.
 
 ## 7.9.1
 
diff --git a/Tests/LMSDT.Tests.ps1 b/Tests/LMSDT.Tests.ps1
@@ -1,3 +1,120 @@
+Describe 'SDT Timezone Resolution (Unit Tests)' {
+    BeforeAll {
+        Import-Module $Module -Force
+    }
+
+    Describe 'Find-LMTimeZoneInfo' {
+        It 'Resolves IANA timezone to a valid TimeZoneInfo' {
+            $result = InModuleScope 'Logic.Monitor' { Find-LMTimeZoneInfo -Timezone 'America/New_York' }
+            $result | Should -Not -BeNullOrEmpty
+            $result | Should -BeOfType [System.TimeZoneInfo]
+        }
+        It 'Resolves IANA Pacific timezone' {
+            $result = InModuleScope 'Logic.Monitor' { Find-LMTimeZoneInfo -Timezone 'America/Los_Angeles' }
+            $result | Should -Not -BeNullOrEmpty
+        }
+        It 'Resolves Windows timezone name' {
+            $result = InModuleScope 'Logic.Monitor' { Find-LMTimeZoneInfo -Timezone 'Eastern Standard Time' }
+            $result | Should -Not -BeNullOrEmpty
+        }
+        It 'Resolves Get-TimeZone StandardName' {
+            $result = InModuleScope 'Logic.Monitor' { Find-LMTimeZoneInfo -Timezone (Get-TimeZone).StandardName }
+            $result | Should -Not -BeNullOrEmpty
+        }
+        It 'Resolves UTC' {
+            $result = InModuleScope 'Logic.Monitor' { Find-LMTimeZoneInfo -Timezone 'UTC' }
+            $result | Should -Not -BeNullOrEmpty
+        }
+        It 'Resolves legacy US shorthand' {
+            $result = InModuleScope 'Logic.Monitor' { Find-LMTimeZoneInfo -Timezone 'US/Eastern' }
+            $result | Should -Not -BeNullOrEmpty
+        }
+        It 'Throws on invalid timezone' {
+            { InModuleScope 'Logic.Monitor' { Find-LMTimeZoneInfo -Timezone 'Not/A/Real/Timezone' } } | Should -Throw
+        }
+    }
+
+    Describe 'Resolve-LMTimezoneToIANAId' {
+        It 'Passes through IANA timezone unchanged' {
+            $result = InModuleScope 'Logic.Monitor' { Resolve-LMTimezoneToIANAId -Timezone 'America/New_York' }
+            $result | Should -Be 'America/New_York'
+        }
+        It 'Converts Windows Eastern to IANA' {
+            $result = InModuleScope 'Logic.Monitor' { Resolve-LMTimezoneToIANAId -Timezone 'Eastern Standard Time' }
+            $result | Should -Be 'America/New_York'
+        }
+        It 'Converts Windows Pacific to IANA' {
+            $result = InModuleScope 'Logic.Monitor' { Resolve-LMTimezoneToIANAId -Timezone 'Pacific Standard Time' }
+            $result | Should -Be 'America/Los_Angeles'
+        }
+        It 'Converts Windows Central to IANA' {
+            $result = InModuleScope 'Logic.Monitor' { Resolve-LMTimezoneToIANAId -Timezone 'Central Standard Time' }
+            $result | Should -Be 'America/Chicago'
+        }
+        It 'Converts Windows Mountain to IANA' {
+            $result = InModuleScope 'Logic.Monitor' { Resolve-LMTimezoneToIANAId -Timezone 'Mountain Standard Time' }
+            $result | Should -Be 'America/Denver'
+        }
+        It 'Passes through unknown timezone unchanged' {
+            $result = InModuleScope 'Logic.Monitor' { Resolve-LMTimezoneToIANAId -Timezone 'Some/Unknown_Zone' }
+            $result | Should -Be 'Some/Unknown_Zone'
+        }
+        It 'Handles UTC' {
+            $result = InModuleScope 'Logic.Monitor' { Resolve-LMTimezoneToIANAId -Timezone 'UTC' }
+            $result | Should -Be 'UTC'
+        }
+        It 'Resolves Get-TimeZone StandardName to an IANA ID' {
+            $result = InModuleScope 'Logic.Monitor' { Resolve-LMTimezoneToIANAId -Timezone (Get-TimeZone).StandardName }
+            $result | Should -Match '/'
+        }
+    }
+
+    Describe 'Test-LMTimezoneId' {
+        It 'Accepts IANA timezone' {
+            $result = InModuleScope 'Logic.Monitor' { Test-LMTimezoneId -Timezone 'America/New_York' }
+            $result | Should -Be $true
+        }
+        It 'Accepts Windows timezone' {
+            $result = InModuleScope 'Logic.Monitor' { Test-LMTimezoneId -Timezone 'Eastern Standard Time' }
+            $result | Should -Be $true
+        }
+        It 'Accepts Get-TimeZone StandardName format' {
+            $result = InModuleScope 'Logic.Monitor' { Test-LMTimezoneId -Timezone (Get-TimeZone).StandardName }
+            $result | Should -Be $true
+        }
+        It 'Accepts empty string' {
+            $result = InModuleScope 'Logic.Monitor' { Test-LMTimezoneId -Timezone '' }
+            $result | Should -Be $true
+        }
+        It 'Rejects invalid timezone' {
+            { InModuleScope 'Logic.Monitor' { Test-LMTimezoneId -Timezone 'Not/A/Real/Timezone' } } | Should -Throw
+        }
+    }
+
+    Describe 'ConvertTo-LMSDTEpochMillis' {
+        It 'Produces same epoch for equivalent IANA and Windows timezones' {
+            $TestDate = Get-Date '2026-06-15 14:00:00'
+            $ianaResult = InModuleScope 'Logic.Monitor' -Parameters @{ TestDate = $TestDate } {
+                ConvertTo-LMSDTEpochMillis -DateTime $TestDate -Timezone 'America/New_York'
+            }
+            $windowsResult = InModuleScope 'Logic.Monitor' -Parameters @{ TestDate = $TestDate } {
+                ConvertTo-LMSDTEpochMillis -DateTime $TestDate -Timezone 'Eastern Standard Time'
+            }
+            $ianaResult | Should -Be $windowsResult
+        }
+        It 'Produces different epochs for different timezones with same wall clock time' {
+            $TestDate = Get-Date '2026-06-15 14:00:00'
+            $easternResult = InModuleScope 'Logic.Monitor' -Parameters @{ TestDate = $TestDate } {
+                ConvertTo-LMSDTEpochMillis -DateTime $TestDate -Timezone 'America/New_York'
+            }
+            $pacificResult = InModuleScope 'Logic.Monitor' -Parameters @{ TestDate = $TestDate } {
+                ConvertTo-LMSDTEpochMillis -DateTime $TestDate -Timezone 'America/Los_Angeles'
+            }
+            ($pacificResult - $easternResult) | Should -Be (3 * 3600 * 1000)
+        }
+    }
+}
+
 Describe 'SDT Testing' {
     BeforeAll {
         Import-Module $Module -Force
@@ -17,7 +134,7 @@ Describe 'SDT Testing' {
     }
 
     Describe 'New-LMDeviceSDT' {
-        It 'When given mandatory parameters, returns a created Device SDT with matching values' {
+        It 'When given mandatory parameters with IANA timezone, returns a created Device SDT with matching values' {
             $StartDate = (Get-Date).AddMinutes(5)
             $EndDate = $StartDate.AddHours(1)
             $Script:NewDeviceSDT = New-LMDeviceSDT -DeviceId 123 -StartDate $StartDate -EndDate $EndDate -Timezone "America/New_York" -Comment "DeviceSDT.Build.Test"
@@ -26,6 +143,23 @@ Describe 'SDT Testing' {
             $Script:NewDeviceSDT.Type | Should -Be "ResourceSDT"
             $Script:NewDeviceSDT.Timezone | Should -Be "America/New_York"
         }
+        It 'When given a Windows timezone name, converts to IANA and creates SDT successfully' {
+            $StartDate = (Get-Date).AddMinutes(5)
+            $EndDate = $StartDate.AddHours(1)
+            $Script:NewDeviceSDTWindows = New-LMDeviceSDT -DeviceId 123 -StartDate $StartDate -EndDate $EndDate -Timezone "Eastern Standard Time" -Comment "DeviceSDT.Windows.TZ.Test"
+            $Script:NewDeviceSDTWindows | Should -Not -BeNullOrEmpty
+            $Script:NewDeviceSDTWindows.Comment | Should -Be "DeviceSDT.Windows.TZ.Test"
+            $Script:NewDeviceSDTWindows.Type | Should -Be "ResourceSDT"
+            $Script:NewDeviceSDTWindows.Timezone | Should -Be "America/New_York"
+        }
+        It 'When given Get-TimeZone StandardName, creates SDT successfully' {
+            $StartDate = (Get-Date).AddMinutes(5)
+            $EndDate = $StartDate.AddHours(1)
+            $Script:NewDeviceSDTGetTZ = New-LMDeviceSDT -DeviceId 123 -StartDate $StartDate -EndDate $EndDate -Timezone (Get-TimeZone).StandardName -Comment "DeviceSDT.GetTZ.Test"
+            $Script:NewDeviceSDTGetTZ | Should -Not -BeNullOrEmpty
+            $Script:NewDeviceSDTGetTZ.Comment | Should -Be "DeviceSDT.GetTZ.Test"
+            $Script:NewDeviceSDTGetTZ.Type | Should -Be "ResourceSDT"
+        }
     }
 
     Describe 'Get-LMDeviceGroupSDT' {
@@ -68,6 +202,12 @@ Describe 'SDT Testing' {
         It 'When given a Device SDT id, remove the SDT from logic monitor' {
             { Remove-LMSDT -Id $Script:NewDeviceSDT.Id -ErrorAction Stop -Confirm:$false } | Should -Not -Throw
         }
+        It 'When given a Windows TZ Device SDT id, remove the SDT from logic monitor' {
+            { Remove-LMSDT -Id $Script:NewDeviceSDTWindows.Id -ErrorAction Stop -Confirm:$false } | Should -Not -Throw
+        }
+        It 'When given a Get-TZ Device SDT id, remove the SDT from logic monitor' {
+            { Remove-LMSDT -Id $Script:NewDeviceSDTGetTZ.Id -ErrorAction Stop -Confirm:$false } | Should -Not -Throw
+        }
     }
     
     AfterAll {
diff --git a/en-US/Logic.Monitor-help.xml b/en-US/Logic.Monitor-help.xml
