{"id":54213,"date":"2009-03-11T21:21:00","date_gmt":"2009-03-11T21:21:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2009\/03\/11\/hey-scripting-guy-how-can-i-search-for-download-and-install-an-update\/"},"modified":"2009-03-11T21:21:00","modified_gmt":"2009-03-11T21:21:00","slug":"hey-scripting-guy-how-can-i-search-for-download-and-install-an-update","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/hey-scripting-guy-how-can-i-search-for-download-and-install-an-update\/","title":{"rendered":"Hey, Scripting Guy! How Can I Search For, Download, and Install an Update?"},"content":{"rendered":"

\"Hey, <\/H2>\n

Hey, Scripting Guy! Reporting on whether a Windows Update is installed or not is pretty cool. However, what happens when I determine the update has not been applied? Am I supposed to call the user and talk them through connecting to the Microsoft Update site and choosing the appropriate update? That may work for one or two users, but it does not scale very well. Surely you have a better plan than that? I mean, you are after all the Microsoft Scripting Guy, not the Microsoft Talks the User Through the GUI Guy. You got a script for me?

– NB<\/P>\"Spacer\"\"Hey, \n

Hi NB,<\/P>\n

Well, we are snowed in down here in Charlotte today. It\u2019s a snow day<\/A>! Woo Hoo! Hey, wait a minute, I work from home, so not much of a snow day after all. Oh well. It looks pretty from my office windows, and the neighbors are in the street with their various snow implements. Looks cold; luckily I am sipping a cup of Constant Comment tea and listening to the Kentucky Headhunters<\/A> on my Zune<\/A>. So you want to be able to search for an update, download the update, and install the update? No problem.<\/P>\n\n<\/THEAD>\n\n\n
\n

This week we will be looking at using the Windows Update API to work with Windows Update. The Windows Update API is documented on MSDN<\/A>. There is also a good collection of VBScripts that use the Windows Update API in the Script Center Script Repository<\/A>. For information about manually configuring Windows Update on workstations, refer to this page<\/A>. These scripts use Windows PowerShell. The Windows PowerShell getting started page<\/A> has basic information for learning about Windows PowerShell and about downloading Windows PowerShell.<\/P><\/TD><\/TR><\/TBODY><\/TABLE>\n

<\/DIV>\n

Today’s script is called InstallSoftwareUpdate.ps1<\/B> and is seen here (a VBScript version of today’s script can be seen in the Script Center Script Repository<\/A>):<\/P>

$UpdateCollection = New-Object -ComObject Microsoft.Update.UpdateColl\n$Searcher = New-Object -ComObject Microsoft.Update.Searcher\n$Session = New-Object -ComObject Microsoft.Update.Session<\/p>\n
$updateID = “f1b1a591-bb75-4b1c-9fbd-03eedb00cc9d”\n$Result = $Searcher.Search(“UpdateID=’$updateID'”)\n$Updates = $Result.updates\n$UpdateCollection.Add($Updates.Item(0)) | out-null<\/p>\n
$Downloader = $Session.CreateUpdateDownloader()\n$Downloader.Updates = $UpdateCollection\n$Downloader.Download()<\/p>\n
$Installer = New-Object -ComObject Microsoft.Update.Installer\n$Installer.Updates = $UpdateCollection\n$Installer.Install()\n<\/PRE><\/PRE>\n
The first thing we need to do is to create an instance of the Microsoft.Update.UpdateColl<\/B> object. This object is known as the IUpdateCollection<\/B> interface and it is documented on MSDN<\/A>. To create the UpdateColl<\/B> object, we use the New-Object<\/B> cmdlet and specify the \u2013ComObject<\/B> parameter and use the Microsoft.Update.UpdateColl<\/B> program ID. The pattern for creating these objects is seen here:<\/P>
$VariableToHoldObject = New-Object \u2013ComObject ProgramIDOFTheComObject<\/PRE>\n
We store the returned UpdateColl<\/B> object in the $UpdateCollection<\/B> variable as shown here:<\/P>
$UpdateCollection = New-Object -ComObject Microsoft.Update.UpdateColl<\/PRE>\n
Next we need to create the Searcher<\/B> object. The Microsoft.Update.Searcher<\/B> object (also known as the IUpdateSearcher<\/B> interface) is documented on MSDN<\/A>. To create the Searcher<\/B> object, we use the New-Object<\/B> cmdlet with the \u2013ComObject<\/B> parameter and supply the Program ID of Microsoft.Update.Searcher<\/B>. We store the returned Searcher<\/B> object in the $Searcher<\/B> variable. This is seen here:<\/P>
$Searcher = New-Object -ComObject Microsoft.Update.Searcher<\/PRE>\n
The next object we need to create is the Session<\/B> object. This object, like the other two objects, begins with Microsoft.Update<\/B>. It also is created with the New-Object<\/B> cmdlet. Also known as the IUpdateSession<\/B> interface, it is documented on MSDN<\/A>. The code that creates the Session<\/B> object is seen here:<\/P>
$Session = New-Object -ComObject Microsoft.Update.Session<\/PRE>\n
To install a software update, we need to first search for the update, add the retrieved update to the update collection, download the update, and finally install the update. If we want to install a specific update, we can use the updateID<\/B> property from the Update Identity<\/B> object. To easily retrieve updateIDs for software updates that are not yet installed, we can use the ListSoftwareUpdatesNotInstalled.ps1<\/B> script (this script is a revision of the ListSoftwareUpdates.ps1<\/B> script we looked at yesterday<\/A>):<\/P>
$Searcher = New-Object -ComObject Microsoft.Update.Searcher\n$results = $searcher.search(“Type=’software’ AND IsInstalled = 0”)\n$Results.Updates | \nForEach-Object { $_.Identity.UpdateID ; “`t” + $_.Title }<\/PRE>\n
We have added the ForEach-Object<\/B> cmdlet to allow us to return the updateID<\/B> property from the Update Identity<\/B> object. We then tab over by using the “`t”<\/B> and print out the title of the update as well by concatenating it via the plus sign (+)<\/B>. The results are seen here:<\/P>\"Image \n
 <\/P>\n
After we have found the update we wish to install, we copy the updateID and assign it to the $UpdateID<\/B> variable. We then use this variable when we call the Search <\/B>method from the Searcher<\/B> object. The query we use for the Searcher<\/B> object is UpdateID =<\/B> the value stored in the $updateID<\/B> variable. The Searcher<\/B> syntax was discussed in yesterday\u2019s \u201cHey, Scripting Guy!\u201d article<\/A>.<\/P>\n
After the update has been found, it is added to the UpdateCollection<\/B> by using the Add<\/B> method. The return code from adding the update to the collection is discarded by piping it to the Out-Null<\/B> cmdlet. The updateID<\/B> f1b1a591-bb75-4b1c-9fbd-03eedb00cc9d is the Windows Search 4.0 for Windows XP (KB940157) update. This section of the code is seen here:<\/P>
$updateID = “f1b1a591-bb75-4b1c-9fbd-03eedb00cc9d”\n$Result = $Searcher.Search(“UpdateID=’$updateID'”)\n$Updates = $Result.updates\n$UpdateCollection.Add($Updates.Item(0)) | out-null\n<\/PRE>\n
We now need to download the updates. To do this, we use the CreateUpdateDownloader<\/B> method from the Session<\/B> object. The resulting download object is stored in the $Downloader<\/B> variable. The updates from the UpdateCollection<\/B> are assigned to the Updates<\/B> property of the Downloader<\/B>, and the Download<\/B> method is called. This section of the script is seen here:<\/P>
$Downloader = $Session.CreateUpdateDownloader()\n$Downloader.Updates = $UpdateCollection\n$Downloader.Download()\n<\/PRE>\n
Now it is time to install the update. To do this, we need to first create an instance of the Installer<\/B> object. The Installer<\/B> object (also known as the IUpdateInstaller<\/B> interface) is documented on MSDN<\/A>. After the Installer object is created, we use the updates stored in the $updateCollection<\/B> variable and assign it to the Updates<\/B> property. We then call the Install<\/B> method as seen here:<\/P>
$Installer = New-Object -ComObject Microsoft.Update.Installer\n$Installer.Updates = $UpdateCollection\n$Installer.Install()\n<\/PRE>\n
After we run the script, this is the output seen on the screen.<\/P>\"Image \n
 <\/P>\n
The HResult<\/B> seen in the preceding image is either the COM or Windows error that was raised during the installation. The ResultCode<\/B> is an OperationResultCode<\/B> enumeration value. A ResultCode<\/B> of 2 means the operation succeeded. The first set of results is returned by the Download<\/B> operation, and the second set of results is returned by the Install<\/B> operation. Table 1<\/B> documents the result codes.<\/P>\n\n\n\n\n\n\n\n\n\n\n\n
Table 1 OperationResultCode enumeration values and meanings<\/TD><\/TR>\n
Return Value<\/TD>\nMeaning<\/TD><\/TR><\/THEAD>\n
\n
0<\/P><\/TD>\n
\n
Not Started<\/P><\/TD><\/TR>\n
\n
1<\/P><\/TD>\n
\n
In Progress<\/P><\/TD><\/TR>\n
\n
2<\/P><\/TD>\n
\n
Succeeded<\/P><\/TD><\/TR>\n
\n
3<\/P><\/TD>\n
\n
Succeeded With Errors<\/P><\/TD><\/TR>\n
\n
4<\/P><\/TD>\n
\n
Failed<\/P><\/TD><\/TR>\n
\n
5<\/P><\/TD>\n
\n
Aborted<\/P><\/TD><\/TR><\/TBODY><\/TABLE>\n
<\/DIV>\n
If a problem occurs during the installation or download, the Installation Results<\/B> object (IInstallationResult interface<\/A>) can at times provide information that is useful in troubleshooting the script. An example of such an error can be seen here:<\/P>\"Image \n
 <\/P>\n
The Installation Results<\/B>HResult<\/B> property returned from the script is documented on MSDN<\/A>. To interpret the results, we need to first convert the value to hexadecimal. To do this, we can use the Calculator (Calc.exe<\/B>) program to make the conversion. I copy the -2145124318<\/B> value from the Windows PowerShell console and paste it into Calculator. When you have done so, it looks like what you see here:<\/P>\"Image \n
 <\/P>\n
To convert the HRESULT<\/B> value to something we can look up, we now need to translate the number into hexadecimal. We check hexadecimal and we also check the Dword<\/B> radio button as seen here:<\/P>\"Image \n
 <\/P>\n
The resulting number 80240022 can be looked up directly in the MSDN documentation<\/A>, which dutifully tells us that the operation failed for all the updates. Additional information can be obtained from the System event log. The source of the event log messages will be Windows Update Agent. In the example seen in the final image below, the error that is reported is 0x80246007<\/B>, which means, as the same MSDN documentation tells us, that the update has not been downloaded.<\/P>\"Image \n
 <\/P>\n
Well, NB, that is about all there is to installing Windows Updates. I think I am going to put on my woolies and go play in the snow. It is a rare event for us to get snow at all, and to have 6 inches of the stuff? That\u2019s truly a snow day. See you tomorrow as Windows Update Week continues. Until then, peace.<\/P>\n
 <\/P>\n
Ed Wilson and Craig Liebendorfer, Scripting Guys<\/B><\/P><\/p>\n","protected":false},"excerpt":{"rendered":"
Hey, Scripting Guy! Reporting on whether a Windows Update is installed or not is pretty cool. However, what happens when I determine the update has not been applied? Am I supposed to call the user and talk them through connecting to the Microsoft Update site and choosing the appropriate update? That may work for one […]<\/p>\n","protected":false},"author":595,"featured_media":87096,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[36,3,45,380],"class_list":["post-54213","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-client-side-management","tag-scripting-guy","tag-windows-powershell","tag-windows-update"],"acf":[],"blog_post_summary":"
Hey, Scripting Guy! Reporting on whether a Windows Update is installed or not is pretty cool. However, what happens when I determine the update has not been applied? Am I supposed to call the user and talk them through connecting to the Microsoft Update site and choosing the appropriate update? That may work for one […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/54213","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/users\/595"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/comments?post=54213"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/54213\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/media\/87096"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/media?parent=54213"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=54213"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=54213"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}