Troubleshooting

You can use the following PowerShell script to:

• Ensure the required directory exists

• Set the correct permissions for the directory

• Ensure the logging registry key exists

• Toggle the Enabled DWORD value of the logging registry key:

  • If set to 0, the script changes the value to 1 (enable logging)

  • If set to 1, it will change the value to 0 (disable logging)

# Check if the script is running with elevated privileges
if (-not ([Security.Principal.WindowsPrincipal] [Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole] "Administrator")) {
    # If not, relaunch the script with elevated privileges
    Start-Process powershell -ArgumentList "-NoProfile -ExecutionPolicy Bypass -File `"$PSCommandPath`"" -Verb RunAs
    exit
}

$path = "HKLM:\SOFTWARE\HID Global\Logging\Products\ActivClient"
$name = "Enabled"
$directoryPath = "C:\Program Files\Common Files\HID Global\Logs"

# Check if the path exists
if (Test-Path $path) {

    # If the path exists, get the current value
    $currentValue = Get-ItemProperty -Path $path -Name $name -ErrorAction SilentlyContinue

if ($currentValue -eq 1) {
 # If the current value is 1, change it to 0
        Set-ItemProperty -Path $path -Name $name -Value 0
Write-Output "Logging turned off."
    } elseif ($currentValue -eq 0) {
        # If the current value is 0, change it to 1
        Set-ItemProperty -Path $path -Name $name -Value 1
Write-Output "Logging turned on."
Write-Output "Logs files location: C:\Program Files\Common Files\HID Global\Logs"
    } else {
        # If the current value does not exist, set it to 1
        New-ItemProperty -Path $path -Name $name -Value 1 -PropertyType DWORD -Force
Write-Output "Logging turned on."
Write-Output "Logs files location: C:\Program Files\Common Files\HID Global\Logs"
    }

} else {

    # If the path does not exist, create it and set the value to 1
    New-Item -Path $path -Force
    New-ItemProperty -Path $path -Name $name -Value 1 -PropertyType DWORD -Force

}

# Check output directory exists, if not create it

if (-Not (Test-Path -Path $directoryPath)) {
    # Create the directory if it does not exist
    New-Item -ItemType Directory -Path $directoryPath
    Write-Output "Output directory was created."
}

# Check and set permissions
$acl = Get-Acl -Path $directoryPath
$accessRule = New-Object System.Security.AccessControl.FileSystemAccessRule("Everyone", "FullControl", "ContainerInherit,ObjectInherit", "None", "Allow")

if (-Not ($acl.Access | Where-Object { $_.IdentityReference -eq "Everyone" -and $_.FileSystemRights -eq "FullControl" })) {
    # Add the access rule if it does not exist
    $acl.SetAccessRule($accessRule)
    Set-Acl -Path $directoryPath -AclObject $acl
    Write-Output "Output directory permissions were set."
}

Your operating system may prevent you from running the provided script for security reasons. If this occurs, you may need to temporarily disable this protection by running:

Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process

Alternatively, you can run the script as follows:

powershell.exe -noprofile -executionpolicy bypass -file .\<script_file_name>

If the required directory exists with appropriate write permissions and the registry key is already present, you can enable logging manually:

1. Open PowerShell as Administrator.

2. Run the following script to set the "Enabled" DWORD value to 1:

   Copy

   New-ItemProperty -Path "HKLM:\Software\HID Global\Logging\Products\ActivClient" -Name "Enabled" -Value 1

3. Restart the workstation if necessary.

If the required directory exists with appropriate write permissions and the registry key is already present, you can enable logging manually:

1. Run regedit.exe from the Windows Start menu.

2. Navigate to HKLM:\Software\HID Global\Logging\Products\ActivClient.

3. Modify the Enabled key value to 1.

   

4. Restart the workstation if necessary.