Unified Communications Management API (UCMA) – Exchange 2013

Exchange 2013 RTM CU1 was released yesterday to the great delight of many Exchange engineers and consultants. One of the little noticed changes in the prerequisites that need to be installed. A while back I created a script to install all the requirements for an Exchange 2013 RTM server. This script included code for UCMA. At the time, version 5.0.8109.3 was the latest version and was apparently a preview version of the software:

UCMA-Preview

If you were to use my script prior to installing Exchange 2013 RTM CU1, you would be in for a surprise when you get to the checks on prerequisites during the install:

UCMA-Preview-02

So how do you fix this issue? First, you can run the code below that will allow you to check to see what version of UCMA you have. If it is the wrong version a link to the correct version will be supplied:

$val = Get-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\{41D635FE-4F9D-47F7-8230-9B29D6D42D31}" -Name "DisplayVersion" -erroraction silentlycontinue
if($val.DisplayVersion -ne "5.0.8308.0"){
   if($val.DisplayVersion -ne "5.0.8132.0"){
	if ((Test-Path "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\{A41CBE7D-949C-41DD-9869-ABBD99D753DA}") -eq $false) {
		write-host "No version of Microsoft Unified Communications Managed API 4.0, Core Runtime 64-bit is " -nonewline 
		write-host "not installed!" -ForegroundColor red
		write-host "Please install the newest UCMA 4.0 from http://www.microsoft.com/en-us/download/details.aspx?id=34992." 
	}else {
	write-host "An old version of Microsoft Unified Communications Managed API 4.0, Core Runtime 64-bit is " -nonewline 
	write-host "installed." -ForegroundColor red
	write-host "This is the incorrect version of UCMA. "  -nonewline -ForegroundColor red 
 	write-host "Please install the newest UCMA 4.0 from http://www.microsoft.com/en-us/download/details.aspx?id=34992." 
	}
   } else {
   write-host "The Preview version of Microsoft Unified Communications Managed API 4.0, Core Runtime 64-bit is " -nonewline
   write-host "installed." -ForegroundColor red
   write-host "This is the incorrect version of UCMA. "  -nonewline -ForegroundColor red 
   write-host "Please install the newest UCMA 4.0 from http://www.microsoft.com/en-us/download/details.aspx?id=34992." 
   }   
} else {
write-host "The correct version of Microsoft Unified Communications Managed API 4.0, Core Runtime 64-bit is " -nonewline
write-host "installed." -ForegroundColor green
}

If you have no UCMA installed, you will see this:

UCMA-Preview-04

If you have the preview UCMA installed, you will see this:

UCMA-Preview-03

And if you have the current UCMA installed, you will see this:

UCMA-Preview-05

I will have a new version of my complete prerequisite script for Exchange 2013 RTM CU1 re-written for this change very soon.

More Information
If you determine you have the wrong version, you can either manually download the file at http://www.microsoft.com/en-us/download/details.aspx?id=34992.

UCMA Runtime information – http://msdn.microsoft.com/en-us/library/lync/hh364915.aspx

Advertisements

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s