This article will help you to troubleshoot the unlock for the OS monitoring feature for Microsoft Windows or in case of an Authentication error while using the Windows Integration Drivers.
If the unlock option is missing, ensure that the WinRM service is enabled and that the Domotz Agent Collector has permission to connect to the WinRM service port (TCP port 5985).
First three steps – Making sure you have run the script in the right way
1) Be sure you have downloaded the latest version of “WIRNM Enable ps script” from here: https://github.com/domotz/support_scripts/raw/main/os_monitoring/enable_winrm_os_monitoring.zip
2) Be sure you are NOT using the Powershell ISE, but instead be sure to run the script from a standard Power Shell console with Administrative Privileges.
3) Run the script: if you would like to run the script for local users please jump to 3a, if your would like to unlock with domain users, please jump to 3b.
3a) Run the script for local windows users: https://help.domotz.com/monitoring-management/os-monitoring-feature/#htoc-run-the-script-for-local-users
In case when you run the script as a local user. After While unlocking the device on the Domotz portal for OS monitoring, in the username field please enter the “$computername\username” as a username.
If you are unsure about the computer name, please open a cmd terminal and run the command “hostname”:
Find your computer's hostname using Command Prompt.
1. Open Command Prompt on your Windows computer.
2. Type the command `hostname` and press Enter.
3. The computer's hostname will be displayed. In this example, it is "DESKTOP-04".
This command shall return the computer name of the system so that you can get the $computername
In the case when you run the script with a username argument and that user does not exist. The script creates a user with the provided username and creates a random password for this user which is mentioned in the same PowerShell terminal where the script has run. Please make sure to use that password while unlocking the Device on Domotz portal, otherwise you would encounter wrong credentials errors. You can also change the password for that newly created user by navigating to users and group settings of the machine.
3b) Run the script for Domain users: https://help.domotz.com/monitoring-management/os-monitoring-feature/#htoc-run-the-script-for-domain-users
Check all the permissions visually
4) Ensure that the account you are using to unlock the device is member of the group you granted the permission to (which is the group name you set as parameter when running the script).
5) Visually verify that the group actually has WinRM and WMI permission
WINRM Permissions:
a. From a PS shell run ‘winrm configsddl default’
b. On the newly opened window verify that the group has the required permissions for the DomotzWinRM group (or the name of the group you used in your use case):
Configuring WinRM Permissions in PowerShell
1. Open PowerShell as an administrator and enter the command: `winrm configsdll default`.
2. In the "Permissions for Default" window, select the relevant user or group under "Group or user names."
3. Ensure the following permissions are checked for "Allow":
- Read (Get, Enumerate, Subscribe)
- Write (Put, Delete, Create)
- Execute (Invoke)
4. Click "OK" to apply the changes.
WMI Permissions:
Check that the group has the required WMI permissions.
a. From a Ps session as Administrator, run the command ‘compmgmt.msc’
b. On the newly created window expand “Services and Applications”, right-click on “WMI Control” and select “Properties“, then select the “Security” tab, expand “Root“, expand “CIMV2” and select the button “Security” a bottom left, then verify that the group has the required permissions:
Accessing WMI Control Security Settings via PowerShell
1. Open PowerShell and type `compmgmt.msc` to launch Computer Management.
2. In the Computer Management window, navigate to "Services and Applications" in the left panel.
3. Find and right-click on "WMI Control," then select "Properties."
4. In the "WMI Control Properties" window, go to the "Security" tab.
5. Expand the "Root" folder, then "CIMV2" under it.
6. Select "CIMV2."
7. Click the "Security" button to configure security settings.
8. In the security window, ensure the "Group or user names" section is correct, and verify that permissions such as "Execute Methods" and "Remote Enable" are checked under the "Allow" column for the appropriate users.
Other troubleshooting
6) You may encounter some issue with specific PowerShell cmdlet inside the script, these are usually in the log file, try to run them under the same context of the user who ran the script (if the user is SYSTEM you can try with PSExec64.exe ), maybe the WMI repository is broken or default security has been changed by GPO or other configuration enforcement tools for security/hardening purposes.
To try to rebuild the broken repository please see here: WMI: Repository Corruption, or Not?
7) If any of the above does not help in your situation, please open a ticket at support@domotz.com providing us the logs which will be extracted from the affected system by running this PowerShell script on it: