Datto RMM

https://rmm.datto.com/help/en
Admin
Datto RMM is a remote monitoring and management platform that enables IT professionals to automate...
Tokens:180,676
Snippets:3,377
Trust Score:10
Update:2 months ago
Show doc for...
Tokens:
Raw
### Install MSI via Batch Script

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Automation/Components/Scripting.htm

Example of referencing an attached file directly within a Batch script to perform an installation.

```Batch
@echo off
msiexec /i install.msi /qn
echo Product Installed Successfully
exit
```

--------------------------------

### Install the Agent on Linux via Terminal

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Devices/AddADevice/InstallLinux.htm

Commands to navigate to the installer directory, set execution permissions, and run the installation script.

```bash
cd[folder containing the Datto RMM .sh file]
```

```bash
sudo chmod +x [file name].sh
```

```bash
sudo sh [file name].sh
```

--------------------------------

### Check Mono Installation and Version

Source: https://rmm.datto.com/help/en/Content/Troubleshooting/TechnicalInformation/KB360021959131.htm

Use this command to verify if Mono is installed and to display the current version information.

```bash
mono --version
```

--------------------------------

### Download and Install Agent via Terminal

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Devices/AddADevice/InstallLinux.htm

Commands to download the agent installer from a URL and execute it, or perform both actions in one line.

```bash
sudo wget [the web address of the Linux Agent from your site] -O agent.sh
```

```bash
sudo sh [the path and file name of the Agent]
```

```bash
sudo wget -O setup.sh [the web address of the Linux Agent from your site] && sudo sh setup.sh
```

--------------------------------

### Execute Datto RMM Agent Installer

Source: https://rmm.datto.com/help/en/Content/Troubleshooting/Agent/KB360021741892.htm

Run the downloaded installer file using the PowerShell call operator.

```powershell
& [path name]\newagent.exe"
```

--------------------------------

### Install Datto RMM Agent via Terminal

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Devices/AddADevice/InstallMac.htm

Download and install the agent package using command-line tools. Replace platform and siteID placeholders with your specific environment values.

```bash
curl -o Agent.zip "https://platform.centrastage.net/csm/profile/downloadMacAgent/siteID"
unzip Agent.zip
sudo installer -pkg "AgentSetup/CAG.pkg" -target /
```

--------------------------------

### Batch Script Output Example

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Automation/Components/Scripting.htm

The expected output when running the basic Batch script example.

```text
Good Morning
```

--------------------------------

### Perform a GET request with C#

Source: https://rmm.datto.com/help/en/Content/2SETUP/APIv2.htm

Use this snippet to execute a GET request using C#. This is provided as csharp_request.cs in the downloadable examples.

```csharp
using (var client = new HttpClient())
{
    client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "YOUR_TOKEN");
    var response = await client.GetAsync("https://api.example.com/v2/account");
    var content = await response.Content.ReadAsStringAsync();
}
```

--------------------------------

### Start sfcbd-watchdog service

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Devices/AddADevice/ManageMonitorESXiDevices.htm

Run this command via SSH to start the watchdog service for CIM data broadcasting.

```bash
/etc/init.d/sfcbd-watchdog start
```

--------------------------------

### Perform a GET request with PowerShell

Source: https://rmm.datto.com/help/en/Content/2SETUP/APIv2.htm

Use this snippet to execute a GET request using PowerShell. This is provided as powershell_request.ps1 in the downloadable examples.

```powershell
$headers = @{ "Authorization" = "Bearer YOUR_TOKEN" }
Invoke-RestMethod -Uri "https://api.example.com/v2/account" -Method Get -Headers $headers
```

--------------------------------

### Basic Batch Script Example

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Automation/Components/Scripting.htm

A simple Batch script demonstrating variable assignment and output.

```Batch
@echo off
set time=Morning
echo Good %time%
```

--------------------------------

### Reinstall Agent on Red Hat-based Systems

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Devices/AddADevice/InstallLinux.htm

Commands to download and execute a fresh agent installer.

```bash
wget -O agent.sh "URL" 
								chmod +x agent.sh 
						sudo ./agent.sh
```

--------------------------------

### Splashtop installer registry path

Source: https://rmm.datto.com/help/en/Content/Troubleshooting/WebPortal/KB360022017771.htm

Registry location to identify the MSI installer path if the local Splashtop client folder is missing.

```registry
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Installer\UserData\S-1-5-18\Products\7B10A05B0871FFC4093AE914344E515F\InstallProperties
```

--------------------------------

### Fix Datto RMM Agent service startup issue

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Devices/AddADevice/InstallMac.htm

Use this command to associate the loopback address with the device hostname in the hosts file if the agent fails to start.

```bash
sudo sh -c 'echo "127.0.0.1 $(uname -n)" >> /etc/hosts'
```

--------------------------------

### Perform a GET request with cURL

Source: https://rmm.datto.com/help/en/Content/2SETUP/APIv2.htm

Use this snippet to execute a GET request using cURL. This is provided as curl_request.bat in the downloadable examples.

```bash
curl -X GET "https://api.example.com/v2/account" -H "Authorization: Bearer YOUR_TOKEN"
```

--------------------------------

### Download Datto RMM Agent via PowerShell

Source: https://rmm.datto.com/help/en/Content/Troubleshooting/Agent/KB360021741892.htm

Use the WebClient object to download the installer to a specified destination path.

```powershell
$source = [Agent download URL you copied]
$dest = [destination path]\Newagent.exe"
$wc = New-Object System.Net.WebClient
$wc.DownloadFile($source, $dest)
```

--------------------------------

### Example cag:// link format

Source: https://rmm.datto.com/help/en/Content/Troubleshooting/GeneralTroubleshooting/KB360037921792.htm

The URI scheme used by the Agent Browser to initiate connections.

```text
cag://?type=connect&deviceid=12908311&cagguid=ee3113fd-baa5-4afa-8de2-5da38e6273d4&loginsession=CC42019004BE87D5AECB3F72F062B858&hostname=ALBERTO-PC&ip=192.168.1.123&username=assistenza%40inetcompany.it&usernameBase64=YXNzaXN0ZW56YUBpbmV0Y29tcGFueS5pdA==&firstname=Inetcompany&lastname=&roleid=5
```

--------------------------------

### GET /v2/account/devices

Source: https://rmm.datto.com/help/en/Content/2SETUP/APIv2.htm

Fetches the devices of the authenticated user's account.

```APIDOC
## GET /v2/account/devices

### Description
Fetches the devices of the authenticated user's account.

### Method
GET

### Endpoint
/v2/account/devices
```

--------------------------------

### Example Error Output for HKCU Access

Source: https://rmm.datto.com/help/en/Content/Troubleshooting/GeneralTroubleshooting/KB360021632571.htm

This error message indicates that the script failed because the HKCU path could not be found when running as SYSTEM.

```text
Set-ItemProperty : Cannot find path  
'HKCU:\Software\Microsoft\Office\Outlook\Addins\O365 Encrypt Button\' because it does not exist.  
At C:\ProgramData\CentraStage\Packages\c679c3aa-078c-4bf6-b916-0b0e0808f0df#\command.ps1:1 char:1  
+ Set-ItemProperty -Path "HKCU:\Software\Microsoft\Office\Outlook\Addin ...  
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~  
+ CategoryInfo : ObjectNotFound: (HKCU:\Software\...Encrypt Button\:String) [Set-ItemProperty], ItemNotFoundException  
+ FullyQualifiedErrorId : PathNotFound,Microsoft.PowerShell.Commands.SetItemPropertyCommand
```

--------------------------------

### List Windows patches using PSWindowsUpdate

Source: https://rmm.datto.com/help/en/Content/Troubleshooting/TechnicalInformation/KB360020860132.htm

This script installs and imports the PSWindowsUpdate module, then retrieves lists of installed and available patches. Requires PowerShell 2.0 or newer and administrative privileges.

```powershell
Set-ExecutionPolicy Unrestricted  
Install-Module -Name PSWindowsUpdate  
Import-Module -Name PSWindowsUpdate   
  
Get-WUList -IsInstalled # This returns the list of installed patches   
Get-WUList # This returns the list of available patches
```

--------------------------------

### Datto RMM Agent PowerShell Deployment Script

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Devices/AddADevice/Windows/MicrosoftIntuneDeploy.htm

A template script to download and install the Datto RMM Agent on Windows devices. Requires customization of the $Platform and $SiteID variables before execution.

```powershell
$Platform="<Paste your platform name here>"
$SiteID="<paste your Site ID here>" 
<# 
Datto RMM Agent deploy by MS Azure Intune 
Designed and written by Jon North, Datto, March 2020 
Download the Agent installer, run it, wait for it to finish, delete it 
#> 
# First check if Agent is installed and instantly exit if so
If (Get-Service CagService -ErrorAction SilentlyContinue) {Write-Output "Datto RMM Agent already installed on this device" ; exit} 
# Download the Agent
$AgentURL="https://$Platform.rmm.datto.com/download-agent/windows/$SiteID" 
$DownloadStart=Get-Date 
Write-Output "Starting Agent download at $(Get-Date -Format HH:mm) from $AgentURL"
try {[Net.ServicePointManager]::SecurityProtocol=[Enum]::ToObject([Net.SecurityProtocolType],3072)}
catch {Write-Output "Cannot download Agent due to invalid security protocol. The`r`nfollowing security protocols are installed and available:`r`n$([enum]::GetNames([Net.SecurityProtocolType]))`r`nAgent download requires at least TLS 1.2 to succeed.`r`nPlease install TLS 1.2 and rerun the script." ; exit 1} 
try {(New-Object System.Net.WebClient).DownloadFile($AgentURL, "$env:TEMP\DRMMSetup.exe")} 
catch {$host.ui.WriteErrorLine("Agent installer download failed. Exit message:`r`n$_") ; exit 1} 
Write-Output "Agent download completed in $((Get-Date).Subtract($DownloadStart).Seconds) seconds`r`n`r`n" 
# Install the Agent
$InstallStart=Get-Date 
Write-Output "Starting Agent install to target site at $(Get-Date -Format HH:mm)..." 
& "$env:TEMP\DRMMSetup.exe" | Out-Null 
Write-Output "Agent install completed at $(Get-Date -Format HH:mm) in $((Get-Date).Subtract($InstallStart).Seconds) seconds." 
Remove-Item "$env:TEMP\DRMMSetup.exe" -Force
Exit
```

--------------------------------

### GET /v2/device/macAddress/{macAddress}

Source: https://rmm.datto.com/help/en/Content/2SETUP/APIv2.htm

Fetches data of the device(s) identified by the given MAC address.

```APIDOC
## GET /v2/device/macAddress/{macAddress}

### Description
Fetches data of the device(s) identified by the given MAC address in the format XXXXXXXXXXXX.

### Method
GET

### Endpoint
/v2/device/macAddress/{macAddress}

### Parameters
#### Path Parameters
- **macAddress** (string) - Required - The MAC address of the device.
```

--------------------------------

### GET /v2/account

Source: https://rmm.datto.com/help/en/Content/2SETUP/APIv2.htm

Fetches information about the authenticated user's account.

```APIDOC
## GET /v2/account

### Description
Fetches information about the authenticated user's account.

### Method
GET

### Endpoint
/v2/account
```

--------------------------------

### GET /v2/site/{siteUid}/devices

Source: https://rmm.datto.com/help/en/Content/2SETUP/APIv2.htm

Fetches the device records of the site identified by the given site Uid.

```APIDOC
## GET /v2/site/{siteUid}/devices

### Description
Fetches the device records of the site identified by the given site Uid.

### Method
GET

### Endpoint
/v2/site/{siteUid}/devices

### Parameters
#### Path Parameters
- **siteUid** (string) - Required - The unique identifier of the site.
```

--------------------------------

### GET /v2/device/{deviceUid}

Source: https://rmm.datto.com/help/en/Content/2SETUP/APIv2.htm

Fetches data of the device identified by the given device Uid.

```APIDOC
## GET /v2/device/{deviceUid}

### Description
Fetches data of the device identified by the given device Uid.

### Method
GET

### Endpoint
/v2/device/{deviceUid}

### Parameters
#### Path Parameters
- **deviceUid** (string) - Required - The unique identifier of the device.
```

--------------------------------

### GET /v2/device/{deviceUid}/alerts/open

Source: https://rmm.datto.com/help/en/Content/2SETUP/APIv2.htm

Fetches the open alerts of the device identified by the given device Uid.

```APIDOC
## GET /v2/device/{deviceUid}/alerts/open

### Description
Fetches the open alerts of the device identified by the given device Uid.

### Method
GET

### Endpoint
/v2/device/{deviceUid}/alerts/open

### Parameters
#### Path Parameters
- **deviceUid** (string) - Required - The unique identifier of the device.
```

--------------------------------

### GET /v2/audit/device/{deviceUid}/software

Source: https://rmm.datto.com/help/en/Content/2SETUP/APIv2.htm

Fetches audited software of the generic device identified by the given device Uid.

```APIDOC
## GET /v2/audit/device/{deviceUid}/software

### Description
Fetches audited software of the generic device identified by the given device Uid.

### Method
GET

### Endpoint
/v2/audit/device/{deviceUid}/software

### Parameters
#### Path Parameters
- **deviceUid** (string) - Required - The unique identifier of the device.
```

--------------------------------

### GET /v2/audit/esxihost/{deviceUid}

Source: https://rmm.datto.com/help/en/Content/2SETUP/APIv2.htm

Fetches audit data of the ESXi host identified by the given device Uid.

```APIDOC
## GET /v2/audit/esxihost/{deviceUid}

### Description
Fetches audit data of the ESXi host identified by the given device Uid.

### Method
GET

### Endpoint
/v2/audit/esxihost/{deviceUid}

### Parameters
#### Path Parameters
- **deviceUid** (string) - Required - The unique identifier of the device.
```

--------------------------------

### GET /v2/audit/device/macAddress/{macAddress}

Source: https://rmm.datto.com/help/en/Content/2SETUP/APIv2.htm

Fetches audit data of the generic device(s) identified by the given MAC address.

```APIDOC
## GET /v2/audit/device/macAddress/{macAddress}

### Description
Fetches audit data of the generic device(s) identified by the given MAC address in the format XXXXXXXXXXXX.

### Method
GET

### Endpoint
/v2/audit/device/macAddress/{macAddress}

### Parameters
#### Path Parameters
- **macAddress** (string) - Required - The MAC address of the device.
```

--------------------------------

### Rebuild WMI Repository

Source: https://rmm.datto.com/help/en/Content/Troubleshooting/GeneralTroubleshooting/KB360022014791.htm

Commands to reset the WMI repository. Use this only as a last resort due to potential risks to installed applications.

```batch
Net stop Winmgmt  
Winmgmt.exe /standalonehost  
Winmgmt.exe /resetrepository  
Net start Winmgmt
```

--------------------------------

### GET /v2/device/{deviceUid}/alerts/resolved

Source: https://rmm.datto.com/help/en/Content/2SETUP/APIv2.htm

Fetches the resolved alerts of the device identified by the given device Uid.

```APIDOC
## GET /v2/device/{deviceUid}/alerts/resolved

### Description
Fetches the resolved alerts of the device identified by the given device Uid.

### Method
GET

### Endpoint
/v2/device/{deviceUid}/alerts/resolved

### Parameters
#### Path Parameters
- **deviceUid** (string) - Required - The unique identifier of the device.
```

--------------------------------

### GET /v2/audit/printer/{deviceUid}

Source: https://rmm.datto.com/help/en/Content/2SETUP/APIv2.htm

Fetches audit data of the printer identified by the given device Uid.

```APIDOC
## GET /v2/audit/printer/{deviceUid}

### Description
Fetches audit data of the printer identified by the given device Uid.

### Method
GET

### Endpoint
/v2/audit/printer/{deviceUid}

### Parameters
#### Path Parameters
- **deviceUid** (string) - Required - The unique identifier of the device.
```

--------------------------------

### GET /v2/audit/device/{deviceUid}

Source: https://rmm.datto.com/help/en/Content/2SETUP/APIv2.htm

Fetches audit data of the generic device identified by the given device Uid.

```APIDOC
## GET /v2/audit/device/{deviceUid}

### Description
Fetches audit data of the generic device identified by the given device Uid.

### Method
GET

### Endpoint
/v2/audit/device/{deviceUid}

### Parameters
#### Path Parameters
- **deviceUid** (string) - Required - The unique identifier of the device.
```

--------------------------------

### Define Unix Script Interpreter

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Automation/Components/Scripting.htm

The shebang line is required at the start of all Unix scripts to specify the command interpreter.

```bash
#!/bin/bash
```

--------------------------------

### Enable Admin$ share access via Registry

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Devices/LANDeployAgent.htm

Run this command in an Administrative Command Prompt to enable access to the administrative share for deployment.

```batch
reg add HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System /v LocalAccountTokenFilterPolicy /t REG_DWORD /d 1 /f
```

--------------------------------

### Launch command prompt as LocalSystem

Source: https://rmm.datto.com/help/en/Content/Troubleshooting/GeneralTroubleshooting/KB360022300612.htm

Execute PsExec to open a new command prompt window running with LocalSystem privileges.

```bash
psexec.exe -hsi cmd.exe
```

--------------------------------

### Copy Log File on Windows

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Sites/NetworkDiscoveryLogFiles.htm

Create a copy of the network log file using the command line.

```cmd
copy networknodelog.txt <give new filename here>.txt
```

--------------------------------

### Enable WBEM on ESXi

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Devices/AddADevice/ManageMonitorESXiDevices.htm

Run this command via SSH to enable the WBEM service on the ESXi host.

```bash
esxcli system wbem set --enable true
```

--------------------------------

### Create macOS Agent Deployment Script

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Devices/AddADevice/Windows/MicrosoftIntuneDeploy.htm

A Bash script template for deploying Datto RMM Agents. Ensure the file is saved with a .bash extension and uses Unix-style (LF) line endings when created on Windows.

```bash
#!/bin/bash
Platform=<Paste your platform name here>
SiteID=<paste your Site ID here>
# Datto RMM Agent deploy designed and written by Jon North, Datto, March 2021
# Download the Agent installer, run it, wait for it to finish, delete it
# First check if Agent is already installed and instantly exit if so
if [ -d "/Applications/AEM Agent.app" ] ; then
echo "Datto RMM Agent already installed on this device" ; exit
fi
# Output target site ID and timestamp
echo "Target site ID: $SiteID"
echo "Current date and time is `date`"
AgentFilename='/tmp/DRMMSetup_'$(date +"%Y-%m-%d_%H-%M")
# Download the Agent
curl -o $AgentFilename.zip https://$Platform.rmm.datto.com/download-agent/mac/$SiteID
# Unzip and install the Agent
mkdir $AgentFilename
unzip -a -o $AgentFilename.zip -d $AgentFilename
installer -pkg "$AgentFilename/AgentSetup/CAG.pkg" -target /
rm $AgentFilename.zip
rm -rf $AgentFilename
exit
```

--------------------------------

### Change Directory to Log Location on Windows

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Sites/NetworkDiscoveryLogFiles.htm

Navigate to the directory containing the log files on a 64-bit Windows system.

```bash
cd "C:/Program Files (x86)/CentraStage"
```

--------------------------------

### Create a Custom Windows Event Log

Source: https://rmm.datto.com/help/en/Content/2SETUP/BestPractices/Best_Practices_Windows_Event_Log_Creation.htm

Checks for the existence of a 'Datto' log and creates it with a 'DRMM' source if it is missing.

```powershell
$logFileExists = Get-EventLog -List | Where-Object { $_.LogDisplayName -eq "Datto" }

if (-not $logFileExists) {
	New-EventLog -LogName "Datto" -Source "DRMM"
	Write-EventLog -LogName "Datto" -Source "DRMM" -EntryType Information -EventId 1 -Message "Datto event log created by the DRMM Agent"
}
```

--------------------------------

### Retrieve an API access token with C#

Source: https://rmm.datto.com/help/en/Content/2SETUP/APIv2.htm

Demonstrates a console application approach to requesting an access token. Requires the Json.NET framework.

```csharp
using System;
using System.Net.Http;
using System.Text;
using Newtonsoft.Json;

namespace DattoRmmApiAuth
{
    class Program
    {
        static void Main(string[] args)
        {
            var client = new HttpClient();
            var authData = new { apiKey = "[API Key]", apiSecret = "[API Secret Key]" };
            var json = JsonConvert.SerializeObject(authData);
            var content = new StringContent(json, Encoding.UTF8, "application/json");

            var response = client.PostAsync("https://api.centrastage.net/v2/authenticate", content).Result;
            var responseString = response.Content.ReadAsStringAsync().Result;
            
            dynamic result = JsonConvert.DeserializeObject(responseString);
            string accessToken = result.access_token;
            
            Console.WriteLine("Access Token: " + accessToken);
        }
    }
}
```

--------------------------------

### Configure Agent Proxy Settings

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Sites/ProxySettings.htm

Use this XML structure to define proxy connection details. Restart the agent after applying changes.

```xml
<!--0 = None-->
     <!--1 = Socks4-->
     <!--2 = Socks5-->
     <!--3 = Http-->
     <setting name=“ProxyType” serializeAs=“String”>
       <value>
       </value>
     </setting>
     <setting name=“ProxyIp” serializeAs=“String”>
       <value>
       </value>
     </setting>
     <setting name=“ProxyPort” serializeAs=“String”>
       <value>
       </value>
     </setting>
     <setting name=“ProxyUsername” serializeAs=“String”>
       <value>
       </value>
     </setting>
     <setting name=“ProxyPassword” serializeAs=“String”>
       <value>
       </value>
     </setting>
```

--------------------------------

### Launch PowerShell as SYSTEM using PSExec

Source: https://rmm.datto.com/help/en/Content/Troubleshooting/GeneralTroubleshooting/KB360021632571.htm

Use this command to open a PowerShell instance running as the SYSTEM user to test script behavior.

```powershell
Start-Process -FilePath cmd.exe -Verb Runas -ArgumentList '/k C:\SysinternalsSuite\PsExec.exe -i -s powershell.exe'
```

--------------------------------

### Copy Log File on Linux

Source: https://rmm.datto.com/help/en/Content/5AGENT/LogFile.htm

Create a copy of a log file using the cp command on Linux.

```bash
cp log.txt <give new filename here>.txt
```

--------------------------------

### Copy log file on Windows

Source: https://rmm.datto.com/help/en/Content/3NEWUI/WebRemote/WebRemoteLogFiles.htm

Use this command to create a copy of the log file in the current directory.

```bash
copy webremotelog.txt <give new filename here>.txt
```

--------------------------------

### Re-register DLLs and Recompile MOF Files

Source: https://rmm.datto.com/help/en/Content/Troubleshooting/GeneralTroubleshooting/KB360022014791.htm

A batch script to reset WMI components, re-register system DLLs, and recompile MOF files. Run this as an Administrator on the target endpoint.

```batch
@ECHO OFF  
sc config winmgmt start= auto  
reg add HKLM\SOFTWARE\Microsoft\Ole /v EnableDCOM /t REG_SZ /d "Y" /f   
reg add HKLM\SOFTWARE\Microsoft\Ole /v LegacyAuthenticationLevel /t REG_DWORD /d "2" /f   
reg add HKLM\SOFTWARE\Microsoft\Ole /v LegacyImpersonationLevel /t REG_DWORD /d "3" /f   
reg delete HKLM\SOFTWARE\Microsoft\Ole /v DefaultLaunchPermission /f   
reg delete HKLM\SOFTWARE\Microsoft\Ole /v MachineAccessRestriction /f   
reg delete HKLM\SOFTWARE\Microsoft\Ole /v MachineLaunchRestriction /f   
NET STOP SharedAccess   
NET STOP winmgmt   
CD %WINDIR%\System32\Wbem\Repository   
DEL /F /Q /S %WINDIR%\System32\Wbem\Repository\*.*   
CD %WINDIR%\system32\wbem   
REGSVR32 /s %WINDIR%\system32\scecli.dll   
REGSVR32 /s %WINDIR%\system32\userenv.dll   
MOFCOMP cimwin32.mof   
MOFCOMP cimwin32.mfl   
MOFCOMP rsop.mof   
MOFCOMP rsop.mfl   
FOR /f %%s IN ('DIR /b /s *.dll') DO REGSVR32 /s %%s   
FOR /f %%s IN ('DIR /b *.mof') DO MOFCOMP %%s   
FOR /f %%s IN ('DIR /b *.mfl') DO MOFCOMP %%s   
MOFCOMP exwmi.mof   
MOFCOMP -n:root\cimv2\applications\exchange wbemcons.mof   
MOFCOMP -n:root\cimv2\applications\exchange smtpcons.mof   
MOFCOMP exmgmt.mof   
rundll32 wbemupgd, UpgradeRepository   
NET STOP Cryptsvc   
DEL /F /Q /S %WINDIR%\System32\catroot2\*.*   
DEL /F /Q C:\WINDOWS\security\logs\*.log   
NET START Cryptsvc   
cd c:\windows\system32   
lodctr /R   
cd c:\windows\sysWOW64   
lodctr /R   
WINMGMT.EXE /RESYNCPERF   
msiexec /unregister   
msiexec /regserver   
REGSVR32 /s msi.dll   
NET START winmgmt   
NET START SharedAccess
```

--------------------------------

### Verify WMI Repository Consistency

Source: https://rmm.datto.com/help/en/Content/Troubleshooting/GeneralTroubleshooting/KB360022014791.htm

Execute this command in an elevated command prompt to check if the WMI repository is consistent.

```cmd
winmgmt /verifyrepository
```

--------------------------------

### Salvage WMI Repository

Source: https://rmm.datto.com/help/en/Content/Troubleshooting/GeneralTroubleshooting/KB360022014791.htm

Run this command in an elevated command prompt to merge readable content from an inconsistent repository into a rebuilt one.

```cmd
winmgmt /salvagerepository
```

--------------------------------

### Copy Log File on Windows

Source: https://rmm.datto.com/help/en/Content/5AGENT/LogFile.htm

Create a copy of a log file within the current directory using the copy command.

```cmd
copy log.txt <give new filename here>.txt
```

--------------------------------

### Accessing Input Variables in Shell

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Automation/Components/InputVariables.htm

Demonstrates usage of Boolean and value-type variables in macOS or Linux environments.

```Shell
#!/bin/bash
if [ "$exampleBoolean" = "true" ]
	then
		printf "There are $exampleNumber lights"
	else
		printf "Not checking number of lights"
fi
```

--------------------------------

### Identify operating system type

Source: https://rmm.datto.com/help/en/Content/2SETUP/BestPractices/Best_Practices_Advanced_Patching.htm

Retrieves the OS product type to distinguish between workstations and servers.

```PowerShell
$osInfo = Get-WmiObject -Class Win32_OperatingSystem  
$osInfo.ProductType
```

--------------------------------

### Add Registry Entry via Command Line

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Devices/UserDefinedFields.htm

Use the REG ADD command to populate a UDF by creating a registry string value under the CentraStage key.

```cmd
REG ADD HKEY_LOCAL_MACHINE\SOFTWARE\CentraStage /v Custom[1-300] /t REG_SZ /d "ValueForFieldHere" /f
```

```cmd
REG ADD HKEY_LOCAL_MACHINE\SOFTWARE\CentraStage /v Custom1 /t REG_SZ /d "Joe Smith" /f
```

--------------------------------

### Copy Windows log file

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Management/AdvancedSoftwareManagementLogFiles.htm

Create a copy of the asm.log file with a new filename on Windows.

```batch
copy asm.log <give new filename here>.txt
```

--------------------------------

### Copy Log File on macOS

Source: https://rmm.datto.com/help/en/Content/5AGENT/LogFile.htm

Create a copy of a log file using the cp command on macOS.

```bash
cp AEMAgentlog.txt <give new filename here>.txt
```

--------------------------------

### Copy macOS log file

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Management/AdvancedSoftwareManagementLogFiles.htm

Create a copy of the asm.log file with a new filename on macOS.

```bash
cp asm.log <give new filename here>.txt
```

--------------------------------

### Copy Log File on macOS

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Sites/NetworkDiscoveryLogFiles.htm

Create a copy of the network log file using the terminal.

```bash
cp networknodelog.txt <give new filename here>.txt
```

--------------------------------

### Identify process using port 5900

Source: https://rmm.datto.com/help/en/Content/Troubleshooting/Agent/KB360021596071.htm

Run this command in a Windows Command Prompt to list the process ID and name of any application currently bound to port 5900.

```batch
@for /f "tokens=5" %v in ('netstat -nao ^| find ^":5900^"') do @tasklist /FI "PID eq %v"
```

--------------------------------

### Manual XML Configuration for User-Defined Fields

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Devices/UserDefinedFields.htm

The original and updated XML structure for defining UDFs within the values.xml file.

```xml
<values>
<value name="DeviceID" type="string">YourDeviceID</value>
</values>
```

```xml
<values>
<value name="DeviceID" type="string">YourDeviceID</value>
<value name="Custom1" type="string">Joe Smith</value>
</values>
```

--------------------------------

### Locate values.xml for macOS

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Devices/UserDefinedFields.htm

Path to the values.xml file used for appending UDF data on macOS systems.

```text
/var/root/.mono/registry/LocalMachine/software/centrastage/values.xml
```

```text
/var/root/.mono/registry/CurrentUser/software/centrastage/values.xml
```

--------------------------------

### Restart the Datto RMM agent service via command line

Source: https://rmm.datto.com/help/en/Content/Troubleshooting/GeneralTroubleshooting/NetworkDiscoveryTroubleshooting.htm

Use this command in an elevated command prompt to stop and restart the CagService on the device acting as the Network Node.

```batch
net stop cagservice & net start cagservice
```

--------------------------------

### Change Directory to Log Location on Linux

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Sites/NetworkDiscoveryLogFiles.htm

Navigate to the log directory using the terminal.

```bash
cd /opt/CentraStage
```

--------------------------------

### Update Debian-based Systems

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Devices/AddADevice/InstallLinux.htm

Commands to update and upgrade the system packages.

```bash
sudo apt-get -y update && sudo apt-get -y upgrade
```

--------------------------------

### Execute PowerShell script as LocalSystem

Source: https://rmm.datto.com/help/en/Content/Troubleshooting/GeneralTroubleshooting/KB360022300612.htm

Run a PowerShell script file from within the elevated command prompt.

```powershell
powershell -File C:\Users\<username>\Desktop\Test.ps1
```

--------------------------------

### Update Red Hat-based Systems

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Devices/AddADevice/InstallLinux.htm

Commands to update and upgrade the system packages.

```bash
sudo yum -y update && sudo yum -y upgrade
```

--------------------------------

### Extract ProductType Property

Source: https://rmm.datto.com/help/en/Content/2SETUP/BestPractices/Best_Practices_Modifying_Onboarding_Script.htm

Accesses the ProductType property from the retrieved OS information object.

```powershell
$osInfo.ProductType
```

--------------------------------

### Navigate to Windows log directory

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Management/AdvancedSoftwareManagementLogFiles.htm

Change the current directory to the location of the Advanced Software Management log files on Windows.

```batch
cd "C:\ProgramData\CentraStage\AEMAgent\DataLog"
```

--------------------------------

### Navigate to PsTools directory

Source: https://rmm.datto.com/help/en/Content/Troubleshooting/GeneralTroubleshooting/KB360022300612.htm

Change the command prompt directory to the location where PsTools was extracted.

```bash
cd C:\Users\<username>\Desktop\PsTools
```

--------------------------------

### Request an API access token with cURL

Source: https://rmm.datto.com/help/en/Content/2SETUP/APIv2.htm

Uses a Windows batch script to request an access token. Ensure the command structure is adapted for your specific operating system if not using Windows.

```batch
curl -X POST -H "Content-Type: application/json" -d "{\"apiKey\": \"[API Key]\", \"apiSecret\": \"[API Secret Key]\"}" https://api.centrastage.net/v2/authenticate
```

--------------------------------

### Restart Datto RMM Agent on Linux

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Devices/RestartADevice.htm

Use these shell commands to restart the Datto RMM Agent service on Linux systems.

```bash
sudo service cag restart
```

```bash
sudo systemctl restart cag
```

```bash
sudo sh /opt/CentraStage/restart_cag
```

--------------------------------

### Basic PowerShell File Monitor Script

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Monitors/CustomComponentMonitor.htm

A script that checks for a file's existence and reports status to Datto RMM using required result tags and exit codes.

```PowerShell
If (test-path "C:\test\test.txt" -erroraction silentlycontinue) {
	write-host '<-Start Result->'
 	write-host "STATUS=File test.txt was present"
 	write-host '<-End Result->'
 	exit 0
} else {
	write-host '<-Start Result->'
 	write-host "STATUS=File test.txt was absent"
 	write-host '<-End Result->'
 	exit 1
}
```

--------------------------------

### Retrieve OS Information via WMI

Source: https://rmm.datto.com/help/en/Content/2SETUP/BestPractices/Best_Practices_Modifying_Onboarding_Script.htm

Queries the Win32_OperatingSystem class to obtain system information.

```powershell
$osInfo = Get-WmiObject -Class Win32_OperatingSystem
```

--------------------------------

### Navigate to macOS log directory

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Management/AdvancedSoftwareManagementLogFiles.htm

Change the current directory to the location of the Advanced Software Management log files on macOS.

```bash
cd /usr/local/share/CentraStage/AEMAgent/DataLog/
```

--------------------------------

### Log an Event to a Custom Log

Source: https://rmm.datto.com/help/en/Content/2SETUP/BestPractices/Best_Practices_Windows_Event_Log_Creation.htm

Writes a warning entry to the specified Windows Event Log.

```powershell
Write-EventLog -logname Datto -source DRMM -entrytype Warning -eventid 2 -message "insert custom event message here"
```

--------------------------------

### Uninstall Agent on Debian-based Systems

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Devices/AddADevice/InstallLinux.htm

Commands to remove the agent, associated directories, and the Mono runtime on Debian distributions.

```bash
sudo chmod +x /opt/CentraStage/uninstall.sh 
								sudo /opt/CentraStage/uninstall.sh
								sudo rm -fr /opt/CentraStage 
								sudo rm -fr /usr/local/share/CentraStage 
								sudo rm -fr /root/.local/share/CentraStage 
						sudo apt-get purge mono-runtime
```

--------------------------------

### Define and invoke variables in scripts

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Automation/Components/Scripting.htm

Use the dollar sign ($) to define and reference variables. Comments are indicated by the hash (#) symbol.

```bash
#comments are defined with the hash key
$color="blue"
echo "The sky is $color"
```

--------------------------------

### Uninstall Agent on Red Hat-based Systems

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Devices/AddADevice/InstallLinux.htm

Commands to remove the agent, associated directories, and the Mono runtime on Red Hat distributions.

```bash
sudo chmod +x /opt/CentraStage/uninstall.sh
								sudo /opt/CentraStage/uninstall.sh 
								sudo rm -fr /opt/CentraStage 
								sudo rm -fr /usr/local/share/CentraStage 
								sudo rm -fr /root/.local/share/CentraStage 
						sudo yum remove mono-runtime
```

--------------------------------

### Restart Datto RMM Agent via Terminal on macOS

Source: https://rmm.datto.com/help/en/Content/Troubleshooting/Agent/KB360022009151.htm

Use these commands in the terminal to restart the agent on macOS systems.

```bash
cd /Applications/"AEM Agent.app"/Contents/Resources
```

```bash
./restart_cag
```

--------------------------------

### Request an API access token with PowerShell

Source: https://rmm.datto.com/help/en/Content/2SETUP/APIv2.htm

Uses a PowerShell function to authenticate and retrieve an access token. Requires PowerShell 3.0 or higher.

```powershell
function Get-AccessToken {
    param(
        [Parameter(Mandatory=$true)]
        [string]$ApiKey,
        [Parameter(Mandatory=$true)]
        [string]$ApiSecret
    )

    $body = @{
        apiKey = $ApiKey
        apiSecret = $ApiSecret
    } | ConvertTo-Json

    $response = Invoke-RestMethod -Uri "https://api.centrastage.net/v2/authenticate" -Method Post -Body $body -ContentType "application/json"
    return $response.access_token
}
```

--------------------------------

### Change Directory to Log Location on macOS

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Sites/NetworkDiscoveryLogFiles.htm

Navigate to the log directory using the terminal.

```bash
cd /var/log
```

--------------------------------

### Local device registry configuration

Source: https://rmm.datto.com/help/en/Content/Troubleshooting/WebPortal/KB360022017771.htm

Registry keys required on the local endpoint to establish the st-CentraStage protocol association.

```registry
[HKEY_CLASSES_ROOT\st-CentraStage]  
@="URL:st-CentraStage Protocol"  
"URL Protocol"=""  
  
[HKEY_CLASSES_ROOT\st-CentraStage\DefaultIcon]  
@="C:\\Program Files (x86)\\Splashtop\\Splashtop Remote\\MSP Remote Support by Splashtop\\clientoobe.exe"  
  
[HKEY_CLASSES_ROOT\st-CentraStage\shell]  
  
[HKEY_CLASSES_ROOT\st-CentraStage\shell\open]  
  
[HKEY_CLASSES_ROOT\st-CentraStage\shell\open\command]  
@="C:\\Program Files (x86)\\Splashtop\\Splashtop Remote\\MSP Remote Support by Splashtop\\clientoobe.exe -a %1"
```

--------------------------------

### Uninstall Datto RMM Agent via Terminal

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Devices/AddADevice/InstallMac.htm

Execute the uninstallation script located within the application bundle to remove the agent from the device.

```bash
sudo bash /Applications/AEM\ Agent.app/Contents/Resources/uninstall.sh
```

--------------------------------

### Configure Finder Visibility

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Devices/AddADevice/InstallMac.htm

Commands to toggle file visibility in Finder. The boolean flag is required for macOS Mavericks 10.9 and later.

```bash
defaults write com.apple.finder AppleShowAllFiles
```

```bash
killall Finder
```

```bash
defaults write com.apple.finder AppleShowAllFiles -boolean true
```

--------------------------------

### Modify /opt/CentraStage/nlog.config Logging Rules

Source: https://rmm.datto.com/help/en/Content/Troubleshooting/Agent/KB360021830471.htm

Change the minimum logging level from Info to Trace for the primary agent log file.

```xml
	<rules>
		<logger name="*" minlevel="Info" writeTo="file" />
		<logger name="*" minlevel="Error" writeTo="errorfile" />
	</rules>
```

```xml
	<rules>
		<logger name="*" minlevel="Trace" writeTo="file" />
		<logger name="*" minlevel="Error" writeTo="errorfile" />
	</rules>
```

--------------------------------

### Uninstall Mono Runtime

Source: https://rmm.datto.com/help/en/Content/Troubleshooting/TechnicalInformation/KB360021959131.htm

These commands remove the Mono runtime and clean up unused dependencies on Debian-based Linux distributions.

```bash
sudo apt-get purge mono-runtime
sudo apt-get autoremove
```

--------------------------------

### Firefox handlers.json configuration

Source: https://rmm.datto.com/help/en/Content/Troubleshooting/GeneralTroubleshooting/KB360037921792.htm

The configuration file structure for Firefox protocol handlers. Locate the 'cag' key to modify or remove the association.

```json
{"defaultHandlersVersion":{"en-US":4},"mimeTypes":{"application/pdf":{"action":3,"extensions":["pdf"]}},"schemes":{"irc":{"action":2,"ask":true,"handlers":[null,{"name":"Mibbit","uriTemplate":"https://www.mibbit.com/?url=%s"}]},"ircs":{"action":2,"ask":true,"handlers":[null,{"name":"Mibbit","uriTemplate":"https://www.mibbit.com/?url=%s"}]},"mailto":{"action":4,"handlers":[null,{"name":"Yahoo! Mail","uriTemplate":"https://compose.mail.yahoo.com/?To=%s"},{"name":"Gmail","uriTemplate":"https://mail.google.com/mail/?extsrc=mailto&url=%s"}]},"cag":{"action":4,"ask":true}}}
```

```json
"cag":{"action":4,"ask":true}
```

```json
"cag":{}
```

--------------------------------

### Verify WUA Patch Response via PowerShell

Source: https://rmm.datto.com/help/en/Content/Troubleshooting/GeneralTroubleshooting/PatchStatusNoData.htm

Use these commands to query the IUpdateSearcher COM object and check if patch metadata is returned.

```powershell
PS > $varUpdateSearcher=$(New-Object -ComObject Microsoft.Update.Session).CreateUpdateSearcher()  
PS > ($varUpdateSearcher.Search('IsInstalled=1').Updates | select -first 1).title  
MSXML 6.0 RTM Security Update (925673)
```

```powershell
PS > $varUpdateSearcher=$(New-Object -ComObject Microsoft.Update.Session).CreateUpdateSearcher()  
PS > ($varUpdateSearcher.Search('IsInstalled=1').Updates | select -first 1).title  
PS >
```

--------------------------------

### PowerShell Monitor Script with Diagnostic Output

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Monitors/CustomComponentMonitor.htm

An enhanced monitor script that includes a diagnostic block to list running processes when a failure condition is met.

```PowerShell
If (test-path "C:\test\test.txt" -erroraction silentlycontinue) {
	write-host '<-Start Result->'
 	write-host "STATUS=File test.txt was present"
 	write-host '<-End Result->'
 	exit 0
} else {
	write-host '<-Start Result->'
 	write-host "STATUS=File test.txt was absent"
 	write-host '<-End Result->'
 	write-host '<-Start Diagnostic->'
 	write-host "- Programs running in memory at alert time:"
 	get-process
 	write-host '<-End Diagnostic->'
 	exit 1
}
```

--------------------------------

### Identify WSUS configuration via PowerShell

Source: https://rmm.datto.com/help/en/Content/2SETUP/BestPractices/Best_Practices_WSUS.htm

Checks the Windows Update registry key for WSUS configuration and updates a specified Datto RMM custom field with a YES or NO value.

```powershell
New-ItemProperty -Path "HKLM:\Software\Centrastage" -Name "Custom6" -Value 'NO' -Force

$regkey = (Get-ItemProperty -Path HKLM:\SOFTWARE\Policies\Microsoft\Windows\WindowsUpdate\AU).UseWUServer

if ($regkey -eq 0) {
	Write-Host "Local WSUS server not configured"
	New-ItemProperty -Path "HKLM:\Software\Centrastage" -Name "Custom6" -Value 'NO' -Force
} 

if ($regkey -eq 1) {
	Write-Host "Local WSUS server configured"
	New-ItemProperty -Path "HKLM:\Software\Centrastage" -Name "Custom6" -Value 'YES' -Force
}
```

--------------------------------

### Modify Datto RMM Agent log level

Source: https://rmm.datto.com/help/en/Content/Troubleshooting/Agent/KB360021830471.htm

Change the logging level for the main agent log file to Trace.

```xml
logger name="*" minlevel="Info" writeTo="file" />
```

```xml
logger name="*" minlevel="Trace" writeTo="file" />
```

--------------------------------

### Identify FIPS-related cryptographic errors in log.txt

Source: https://rmm.datto.com/help/en/Content/Troubleshooting/TechnicalInformation/KB360021387932.htm

This log entry indicates a failure during package download caused by the Windows FIPS-validated cryptographic algorithms policy.

```text
2018-10-25 11:32:49.2478 WARN (SoftwareJobWorker-40) - Could not download package 609d1778-444c-4d3b-af5f-c2815cb48dab System.Reflection.TargetInvocationException: Exception has been thrown by the target of an invocation. ---> System.InvalidOperationException: This implementation is not part of the Windows Platform FIPS validated cryptographic algorithms.  
at System.Security.Cryptography.MD5CryptoServiceProvider..ctor()  
-- End of inner exception stack trace ---  
at System.RuntimeMethodHandle.InvokeMethod(Object target, Object[] arguments, Signature sig, Boolean constructor)  
at System.Reflection.RuntimeConstructorInfo.Invoke(BindingFlags invokeAttr, Binder binder, Object[] parameters, CultureInfo culture)  
at System.Security.Cryptography.CryptoConfig.CreateFromName(String name, Object[] args)  
at System.Security.Cryptography.MD5.Create()  
at CentraStage.Cag.Core.Agent.SoftwareJobWorker.VerifyAndExtractToFolder(String fileName, String destinationDir, SoftwareJobComponent comp)  
at CentraStage.Cag.Core.Agent.SoftwareJobWorker.Execute(SoftwareJobComponent comp, Boolean downloadOnly, Boolean allowCache, Int32 downloadTimeOutMinutes)
```

--------------------------------

### Log file error message

Source: https://rmm.datto.com/help/en/Content/Troubleshooting/WebPortal/KB360022017771.htm

The specific error string found in the Datto RMM log file indicating a registry association issue.

```text
INFO (Relay-22) - Error processing 'splashtop' relay request System.ComponentModel.Win32Exception (0x80004005): No application is associated with the specified file for this operation
```

--------------------------------

### Accessing Input Variables in PowerShell

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Automation/Components/InputVariables.htm

Requires the $env: prefix to access input variables. Booleans are evaluated as string values.

```PowerShell
if ($env:exampleVariable -eq "true") {
	write-host "Example variable was set to true"
} else {
	write-host "Example variable was not set to true"
}
```

--------------------------------

### Antivirus Override JSON Format

Source: https://rmm.datto.com/help/en/Content/3NEWUI/AntivirusDetection.htm

The required JSON structure for reporting antivirus product name, running status, and update status. Ensure values are lowercase strings to avoid parsing failures.

```json
{"product":"Override Antivirus","running":true,"upToDate":true}
```

--------------------------------

### Modify Linux networknode and webremote nlog.config

Source: https://rmm.datto.com/help/en/Content/Troubleshooting/Agent/KB360021830471.htm

Updates the logging configuration for networknode or webremote components to trace level.

```xml
	<rules>
		<logger name="networknode" minlevel="info" />
	</rules>
</nlog>
```

```xml
	<rules>
		<logger name="networknode" minlevel="trace" />
	</rules>
</nlog>
```

--------------------------------

### Stop Datto RMM Agent Service

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Devices/Cloning.htm

Commands to stop the agent service before performing cloning operations.

```batch
sc stop cagservice
```

```powershell
stop-service cagservice
```

--------------------------------

### Automate UDF Updates with Bash Script

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Devices/UserDefinedFields.htm

A bash script to locate the values.xml file and append a new UDF value automatically. Replace 'X' in 'CustomX' with the desired UDF number (1-10).

```bash
#!/bin/bash
UDFOut=”xxxxxxx” # This will be the output from your script.
ExitCode=0 # This would be set to 0 or 1 somewhere in your script.
XMLPath=$(find /var/root/.mono/registry -name "values.xml") # Get the correct path of the values.xml file.
XMLTemp=$(cat $XMLPath | grep -v "</values>") # Create a string variable of the content of the values.xml file 
barring the last line.
XMLTemp="$XMLTemp"$'
'"<value name=\"CustomX\" type=\"string\">$UDFOut</value>"$'
'"</values>" # Append the 
UDFOut variable to the string variable containing the contents of values.xml. You must replace X with a number 
1-10 for the respective UDF.
rm $XMLPath # Delete original values.xml
echo "$XMLTemp" >> $XMLPath # Copy the contents of the original values.xml plus append into a new values.xml
exit $ExitCode # Exit with respective ExitCode.
```

--------------------------------

### Read Attached File Content in PowerShell

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Automation/Components/Scripting.htm

Use the current directory path prefix to access files attached to a component.

```powershell
#this comment line won't be parsed
Get-Content file.txt
```

--------------------------------

### Invoke Variables in PowerShell

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Automation/Components/Scripting.htm

Distinguish between standard script variables and component-defined environment variables using the $env: prefix.

```powershell
#Regular variable
$color="blue"
write-host "The sky is $color"
#Component variable
write-host "Today is $env:day"
```

--------------------------------

### Stop Agent Service on Linux

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Devices/Cloning.htm

Commands to stop the Datto RMM Agent service and remove the values.xml file on Linux.

```bash
sudo su -
systemctl stop cag
/root/.mono/registry/CurrentUser/software/centrastage
rm -f values.xml
```

--------------------------------

### Conditional OS Detection

Source: https://rmm.datto.com/help/en/Content/2SETUP/BestPractices/Best_Practices_Modifying_Onboarding_Script.htm

Uses IF statements to execute logic based on whether the script is running on a workstation or server OS.

```powershell
if ($osInfo.ProductType -eq 1){
	write-host Workstation OS Detected
}
```

```powershell
if ($osInfo.ProductType -ne 1){
	write-host Server OS Detected
}
```

```powershell
if ($osInfo.ProductType -ne 1){
	write-host Server OS Detected
}
else {
	write-host Workstation OS Detected
}
```

```powershell
if ($osInfo.ProductType -eq 1){
	write-host Workstation OS Detected
	# Insert your custom PowerShell code here
}
```

--------------------------------

### Modify Network Node Logging Rules

Source: https://rmm.datto.com/help/en/Content/Troubleshooting/Agent/KB360021830471.htm

Update the network node logging configuration to capture trace-level events.

```xml
	<rules>
		<logger name="log" minlevel="info" writeTo="log,console" />
	</rules>
</nlog>
```

```xml
	<rules>
		<logger name="log" minlevel="trace" writeTo="log,console" />
	</rules>
</nlog>
```

--------------------------------

### Check WMI Repository Health

Source: https://rmm.datto.com/help/en/Content/Troubleshooting/GeneralTroubleshooting/KB360022014791.htm

Run this script in an administrator PowerShell session to query WMI classes and identify potential corruption.

```powershell
"ComputerSystem","Baseboard","Bios" | % {  
try {  
gwmi win32_$_ -ea 1  
} catch {  
write-host "! WMI ERROR When polling Win32_$_. "  
write-host " Error details:"  
$error | select *  
}
}
```

--------------------------------

### POST /v2/alert/{alertUid}/resolve

Source: https://rmm.datto.com/help/en/Content/2SETUP/APIv2.htm

Resolves an alert identified by the alertUid.

```APIDOC
## POST /v2/alert/{alertUid}/resolve

### Description
Resolves an alert identified by the alertUid.

### Method
POST

### Endpoint
/v2/alert/{alertUid}/resolve

### Parameters
#### Path Parameters
- **alertUid** (string) - Required - The unique identifier of the alert.
```

--------------------------------

### Remote device registry configuration

Source: https://rmm.datto.com/help/en/Content/Troubleshooting/WebPortal/KB360022017771.htm

Registry keys required on the remote device to establish the st-streamer protocol association.

```registry
[HKEY_CLASSES_ROOT\st-streamer]  
@="URL:st-streamer Protocol"  
"URL Protocol"=""  
  
[HKEY_CLASSES_ROOT\st-streamer\DefaultIcon]  
@="C:\\Program Files (x86)\\Splashtop\\Splashtop Remote\\Server\\SRServer"  
  
[HKEY_CLASSES_ROOT\st-streamer\shell]  
  
[HKEY_CLASSES_ROOT\st-streamer\shell\open]  
  
[HKEY_CLASSES_ROOT\st-streamer\shell\open\command]  
@="C:\\Program Files (x86)\\Splashtop\\Splashtop Remote\\Server\\SRUtility.exe -a %1"
```

--------------------------------

### Accessing Input Variables in VBScript

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Automation/Components/InputVariables.htm

Retrieves the value of a string variable using the WScript Shell environment object.

```VBScript
CreateObject("WScript.Shell").Environment("Process").Item("MyVar")
```

--------------------------------

### Microsoft Teams Alert Triggered Payload Template

Source: https://rmm.datto.com/help/en/Content/3NEWUI/Monitors/Webhooks.htm

Placeholder for the Microsoft Teams alert triggered JSON payload.

```json
 
```
Tokens:
Raw