Maintenance Mode Schedule

[ppelletier1]

It would really be nice to have a function to set a maintenance mode schedule, even a basic one. All it would need for a basic one would be the DeviceId, Start-Date, Start-Time, End-Date, End-Time...

Thoughts?

[jayyx2]

I like this idea! /api/v1/devices/{deviceId}/config/maintenance/schedule seems to be the REST API endpoint that makes this possible. I'll take a peek at this soon. Thanks so much for the suggestion.

[ppelletier1]

Also, maybe an option to clear the MM schedule... Thanks so much for this! I just found this and am already using it quite a bit!

[jayyx2]

I am working toward adding Get-WUGDeviceMaintenanceSchedule and Set-WUGDeviceMaintenanceSchedule. Part of my goal with this is to make sure you can use them together to copy a config from one device to other devices. For example:

$schedule = Get-WUGDeviceMaintenanceSchedule
Set-WUGDeviceMaintenanceSchedule -DeviceID $arrayOfdevices -Config $schedule

[jayyx2]

I made Set-WUGDeviceMaintenanceSchedule work with a manual configuration, copying the config(s) from other device(s), as well as -DeleteAllSchedules flag to remove all existing maintenance schedules. These will be part of the next update. I learned a lot here, which resulted in additional changes to most of the existing functions. Thanks again for the suggestion!

[ppelletier1]

Thanks! Very happy about this! I'll give it a try!

[ppelletier1]

I just gave it a try and it works. Only problem I have is the EffectiveExpirationDate. What format does it use? I tried the same format as EffectiveStartDate, but that didn't work.

Thanks!

[jayyx2]

I just gave it a try and it works. Only problem I have is the EffectiveExpirationDate. What format does it use? I tried the same format as EffectiveStartDate, but that didn't work.

Thanks!

I'll take a closer look at this soon. I believe the API expects the same format.

• https://docs.ipswitch.com/NM/WhatsUpGold2024/02_Guides/rest_api/index.html#operation/Device_UpdateMaintenanceSchedule
• https://docs.ipswitch.com/NM/WhatsUpGold2024/02_Guides/rest_api/index.html#operation/Device_UpdateMaintenanceBatchSchedule

[ppelletier1]

Thanks! Much appreciated!

[ppelletier1]

I think that when you're building the $schedule object, you have the start date, but not the expiration... It's not seeing it in the debug either...
Debug.txt

[jayyx2]

Would you please try again with https://github.com/jayyx2/WhatsUpGoldPS/blob/main/functions/Set-WUGDeviceMaintenanceSchedule.ps1 instead? I haven't push this to PSGallery yet, so you'll have to do some copy/paste.

[ppelletier1]

Ok. It does work if I enumerate everything on the line instead of using a -Config. However, there's a small bug in there also if you choose midnight (StartTimeHour = 0, StartTimeMinute = 0) as it sees those values as null...

[ppelletier1]

Actually, it doesn't like StartTimeHour = 0...

[ppelletier1]

Weird that it works when I use -Config...

[jayyx2]

Ok. It does work if I enumerate everything on the line instead of using a -Config. However, there's a small bug in there also if you choose midnight (StartTimeHour = 0, StartTimeMinute = 0) as it sees those values as null...

Actually, it doesn't like StartTimeHour = 0...

Thank you for your help with this, I will take a closer look this weekend.

[ppelletier1]

I think that instead of testing for a nul value, have it look for a value outside of 0 thru 23...