Restructured Documentation

scripts/Windows and Linux/Windows/Start the RMM Agent Service Across the Domain.md

@@ -0,0 +1,43 @@
+---
+tags:
+  - PowerShell
+  - Scripting
+---
+
+## Purpose
+Start the `cagservice` RMM agent service on the domain servers selected by the script.  The current implementation starts that service; it does not reboot computers or restart every service.
+
+!!! warning "Under Connstruction"
+    This document is under construction and not generalized for general purpose use yet.  Manual work needs to be done to repurpose this script for general usage.
+
+```powershell
+# Clear the screen before running the script
+Clear-Host
+Write-Host "Starting Domain-Wide Service Restart" -ForegroundColor Green
+
+# Main Script -------------------------------------------------------------------------------------------------------------------------
+
+# Get a list of all servers from Active Directory
+Write-Host "Retrieving server list from Active Directory..."
+$servers = Get-ADComputer -Filter * -Property OperatingSystem | Where-Object {
+    $_.OperatingSystem -like "*Server*"
+} | Select-Object -ExpandProperty Name
+
+# Loop through all servers and start the 'cagservice' service
+foreach ($server in $servers) {
+    Write-Host ("Attempting to start 'cagservice' on " + $server + "...")
+    try {
+        Invoke-Command -ComputerName $server -ScriptBlock {
+            Start-Service -Name cagservice -ErrorAction Stop
+            Write-Host "'cagservice' started successfully on $env:COMPUTERNAME"
+        } -ErrorAction Stop
+    } catch {
+        Write-Host ("Failed to start 'cagservice' on " + $server + ": " + $_.Exception.Message) -ForegroundColor Red
+    }
+}
+
+Write-Host "Script execution completed." -ForegroundColor Green
+```
+
+## Related Documentation
+- [Related Windows and Linux Documentation](<../../../reference/Windows and Linux/index.md>) — Find the connected deployments, procedures, and references for this subject.