Origin script new oem update with prompt

docs/dattormm/components/invoke-oem-update-with-prompt.md

@@ -0,0 +1,154 @@
+---
+id: 'caaa861f-9e69-4449-810b-4f602426624d'
+slug: /caaa861f-9e69-4449-810b-4f602426624d
+title: 'OEM Update With Prompt'
+title_meta: 'OEM Update With Prompt'
+keywords: ['oem', 'update', 'firmware', 'driver', 'bios', 'lenovo', 'dell', 'hp', 'pswindowsupdate', 'prompt', 'reboot']
+description: 'Manages prompting end users before OEM BIOS and Firmware upgrades on Windows 10/11 devices.'
+tags: ['windows', 'dell', 'lenovo', 'hp', 'notifications', 'drivers', 'bios', 'firmware']
+draft: false
+unlisted: false
+last_update:
+  date: 2026-06-01
+---
+
+## Overview
+
+This is a Datto implementation of the agnostic [Invoke-OEMUpdateWithPrompt](/docs/52c50165-38d5-4793-b751-97260ab31f72)
+
+The script prompts logged-in users before BIOS and firmware updates, allows postponement for a configured number of cycles, and then enforces the update. It is designed for a single deployment from Datto RMM, then continues through scheduled task re-runs on the endpoint.
+
+## Dependencies
+
+ - [Agnostic Script - Invoke-OEMUpdateWithPrompt](/docs/52c50165-38d5-4793-b751-97260ab31f72)
+
+## Implementation  
+
+1. Download the component `OEM Update With Prompt` from the attachments.
+
+2. After downloading the attached file, click on the `Import` button
+3. Select the component just downloaded and add it to the Datto RMM interface.  
+
+    ![Image 1](../../../static/img/docs/caaa861f-9e69-4449-810b-4f602426624d/import.webp)  
+
+## Sample Run
+
+To execute the `OEM Update With Prompt` over a specific machine, follow these steps:  
+
+1. Select the machine you want to run the `OEM Update With Prompt` on from the Datto RMM.  
+
+2. Click on the `Quick Job` button.  
+
+    ![Image 2](../../../static/img/docs/caaa861f-9e69-4449-810b-4f602426624d/quickjob.webp)  
+
+3. Search the component `OEM Update With Prompt` and click on `Select`
+
+    ![Image 3](../../../static/img/docs/caaa861f-9e69-4449-810b-4f602426624d/search.webp)
+
+## Examples
+
+### Scenario 1: OEMScriptParametersOverride
+
+Custom parameter string passed to the vendor update script, replacing the default parameter set for the detected manufacturer.
+
+  ![Image 52](../../../static/img/docs/caaa861f-9e69-4449-810b-4f602426624d/runn2.webp)
+
+  - For PSWindowsUpdate, set `OEMScriptParametersOverride` = `-Category 'Drivers','Tools' -AllowReboot`
+  - For Dell DCU, set `OEMScriptParametersOverride` = `/applyUpdates -updateType=bios -silent`
+
+### Scenario 2: UsePsWindowsUpdate
+
+Run with user parameter `UsePsWindowsUpdate = True`.
+
+Expected output:
+
+- Update execution path uses Install-WindowsUpdates flow.
+- This runs Windows update instead of vendor-specific updates
+
+### Scenario 3: IfNotLoggedIn
+
+Run with user parameter `IfNotLoggedIn = True`.
+
+Expected output:
+
+- If no user session is active, update starts without prompting.
+- If a user is logged in, normal prompt workflow continues.
+
+### Scenario 4: HandleBitLocker
+
+Run with user parameter `HandleBitLocker = True`.
+
+Expected output:
+
+- BitLocker is suspended before update execution for one reboot cycle.
+- If no reboot is needed, BitLocker is resumed at completion.
+
+### Scenario 5: Force
+
+Run with user parameter `Force = True`.
+
+Expected output:
+
+- Existing OEM prompt scheduled tasks are removed.
+- Stored prompt state is reset.
+- Prompt workflow starts again from the beginning.
+
+### Scenario 6: SkipWeekends
+
+Run with user parameter `SkipWeekends = True`.
+
+Expected output:
+
+- There will be no popup get generated on the users machine during weekend.
+- Will is usefull as user will not miss any popup during weekends.
+
+
+## Sample Prompts
+
+The First prompt that will get generated on the user machine.     
+![Image 1](../../../static/img/docs/caaa861f-9e69-4449-810b-4f602426624d/update-option.webp)
+
+
+This prompt is shown while the update needs to be schedule on particular time.  
+![Image 2](../../../static/img/docs/caaa861f-9e69-4449-810b-4f602426624d/schedule-option.webp)
+
+
+The prompt shows the confirmation that update is scheduled and will start on the particular time and need aknowledgement.  
+![Image 3](../../../static/img/docs/caaa861f-9e69-4449-810b-4f602426624d/schedule-firmware.webp)
+
+
+The prompt shows the confirmation that update has been completed and reboot is required.  
+![Image 4](../../../static/img/docs/caaa861f-9e69-4449-810b-4f602426624d/last-updated.webp)
+
+## Datto Variables
+
+| Variable Name | Default | Type | Description |
+| --- | --- | --- | --- |
+| `MaxPostpone` | `5` | String | Maximum number of times the upgrade can be postponed before the final prompt is shown. Total prompts = MaxPostpone + 1 (final). |
+| `IntervalMinutes` | `240` | String | Minutes between each prompt. After postpone or miss, a SYSTEM scheduled task re-runs the script at this interval. |
+| `RegularPromptTimeout` | `600` | String | Seconds before a regular prompt auto-closes and counts as missed. |
+| `FinalPromptTimeout` | `900` | String | Seconds before the final prompt times out and the upgrade is forced. |
+| `DelayAfterFinalPrompt` | `600` | String | Seconds to wait before forcing the upgrade after the final prompt times out or user picks a time < 15 min away. |
+| `SkipWeekends` | `False` | Boolean | Prevents prompts on Saturdays and Sundays. |
+| `IfNotLoggedIn` | `False` | Boolean | Runs the upgrade immediately without prompting if no user is logged in. |
+| `Force` | `False` | Boolean | Clears all scheduled tasks and stored state, restarting the prompt cycle from 0. |
+| `UsePsWindowsUpdate` | `False` | Boolean | Uses the PSWindowsUpdate module instead of OEM-specific scripts (Dell/HP/Lenovo). |
+| `HandleBitLocker` | `False` | Boolean | Suspends BitLocker protection on the OS drive for one reboot cycle before OEM updates run. If no reboot is required after the update, BitLocker protection is automatically resumed. |
+| `SuppressPopupTimeWindows` |  | String | Time window (24-hour format, e.g., `1800-0900`) during which prompts are suppressed. |
+| `Icon` |  | String | URL or local file path for the icon displayed in the prompt dialog (e.g., `https://example.com/icon.png` or `C:\Icons\icon.png`). |
+| `HeaderImage` |  | String | URL or local file path for the header image displayed at the top of the prompt dialog (e.g., `https://example.com/header.png` or `C:\Images\header.png`). |
+| `OEMScriptParametersOverride` |  | String | Custom parameter string passed to the vendor update script, replacing the default parameter set for the detected manufacturer (e.g., `'/applyUpdates -updateType=bios -silent'` for Dell DCU or `-Category 'Drivers','Tools' -AllowReboot` for PSWindowsUpdate). |
+
+## Output
+
+Activity Log
+
+## Attachments  
+
+[OEM Update With Prompt](../../../static/attachments/oem-update-with-prompt.cpt)
+
+## Changelog
+
+### 2026-06-01
+
+- Initial version of the document