Create a Custom Detection Script for Azure Connected Machine Agent (PowerShell)

by

Microsoft Endpoint Manager Configuration Manager (MEMCM / SCCM) and Microsoft Intune use Detection Rules to determine the presence of Applications & Win32 Apps. The detection rules ensure that application installations only begin to run if the application is not already installed on the device. This article will serve as an informative guide and give you a clear understanding of how to create an updated custom detection script for each new version of Azure Connected Machine Agent using PowerShell.

How to Create a Custom Detection Script for Azure Connected Machine Agent

Azure Connected Machine Agent (File Detection Method)

## Check for Azure Connected Machine Agent (File Detection Method)
$AzCMAgentExe = (Get-ChildItem -Path "C:\Program Files\AzureConnectedMachineAgent\azcmagent.exe" -ErrorAction SilentlyContinue)
$AzCMAgentExe.FullName
$AzCMAgentPath = $($AzCMAgentExe.FullName).Replace("C:\Program Files\","")
$FileVersion = (Get-Item -Path "$($AzCMAgentExe.FullName)" -ErrorAction SilentlyContinue).VersionInfo.FileVersion

## Create Text File with Azure Connected Machine Agent File Detection Method
$FilePath = "C:\Windows\Temp\Azure_Connected_Machine_Agent_Detection_Method.txt"
New-Item -Path "$FilePath" -Force
Set-Content -Path "$FilePath" -Value "If([String](Get-Item -Path `"`$Env:ProgramFiles\$AzCMAgentPath`" -ErrorAction SilentlyContinue).VersionInfo.FileVersion -ge `"$FileVersion`"){"
Add-Content -Path "$FilePath" -Value "Write-Host `"Installed`""
Add-Content -Path "$FilePath" -Value "Exit 0"
Add-Content -Path "$FilePath" -Value "}"
Add-Content -Path "$FilePath" -Value "else {"
Add-Content -Path "$FilePath" -Value "Exit 1"
Add-Content -Path "$FilePath" -Value "}"
Invoke-Item $FilePath
  • Click Run Script (F5)
  • A text file will open with the Azure Connected Machine Agent Detection Method script required to detect the current version of Azure Connected Machine Agent that is installed on the device you are running the script from.

Example: 

If([String](Get-Item -Path "$Env:ProgramFiles\AzureConnectedMachineAgent\azcmagent.exe" -ErrorAction SilentlyContinue).VersionInfo.FileVersion -ge "1.45.02769.1796"){
Write-Host "Installed"
Exit 0
}
else {
Exit 1
}

Azure Connected Machine Agent (Registry Detection Method)

## Check for Azure Connected Machine Agent (Registry Detection Method)
$AzCMAgent = Get-ChildItem -Path "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall" | Get-ItemProperty | Where-Object {$_.DisplayName -match 'Azure Connected Machine Agent' } | Select-Object -Property DisplayName, DisplayVersion, PSChildName
$AzCMAgent.DisplayVersion
$AzCMAgent.PSChildName

## Create Text File with Azure Connected Machine Agent Registry Detection Method
$FilePath = "C:\Windows\Temp\Azure_Connected_Machine_Agent_Detection_Method.txt"
New-Item -Path "$FilePath" -Force
Set-Content -Path "$FilePath" -Value "If([Version](Get-ItemPropertyValue -Path 'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\$($AzCMAgent.PSChildName)' -Name DisplayVersion -ea SilentlyContinue) -ge '$($AzCMAgent.DisplayVersion)') {"
Add-Content -Path "$FilePath" -Value "Write-Host `"Installed`""
Add-Content -Path "$FilePath" -Value "Exit 0"
Add-Content -Path "$FilePath" -Value "}"
Add-Content -Path "$FilePath" -Value "else {"
Add-Content -Path "$FilePath" -Value "Exit 1"
Add-Content -Path "$FilePath" -Value "}"
Invoke-Item $FilePath
  • Click Run Script (F5)
  • A text file will open with the Azure Connected Machine Agent Detection Method script required to detect the current version of Azure Connected Machine Agent that is installed on the device you are running the script from.

Example: 

If([Version](Get-ItemPropertyValue -Path 'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\{41E489D8-B6F2-4AEB-A132-6A243FB69646}' -Name DisplayVersion -ea SilentlyContinue) -ge '1.45.02769.1796') {
Write-Host "Installed"
Exit 0
}
else {
Exit 1
}

Always make sure to test everything in a development environment prior to implementing anything into production. The information in this article is provided “As Is” without warranty of any kind.