{"id":55093,"date":"2008-09-12T02:23:00","date_gmt":"2008-09-12T02:23:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2008\/09\/12\/hey-scripting-guy-how-can-i-read-from-excel-without-using-excel\/"},"modified":"2008-09-12T02:23:00","modified_gmt":"2008-09-12T02:23:00","slug":"hey-scripting-guy-how-can-i-read-from-excel-without-using-excel","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/hey-scripting-guy-how-can-i-read-from-excel-without-using-excel\/","title":{"rendered":"Hey, Scripting Guy! How Can I Read from Excel Without Using Excel?"},"content":{"rendered":"

<\/p>\n

<\/span><\/font><\/span><\/font><\/h2>\n
\"Hey, <\/p>\n

Hey, Scripting Guy! I have an Microsoft Office Excel spreadsheet with server names in it, and I would like to be able to use this in a Windows PowerShell script. The thing is, I do not have Microsoft Office or Excel installed on the server. How can I use this spread sheet without installing Office on my server (which I understand is unsupported anyway)?<\/p>\n

– FE<\/p>\n

\"Spacer\"\"Hey, <\/p>\n

Hi FE,<\/p>\n

So you want to be able to use Excel, but you do not want to install Excel? Sounds like one of those riddles I heard when I was a kid. You know those things like, “If you take a red crayon and color all the pages in the book so that no one can see any of the writing, is it a red book?” (Or is it a read book? Homophones can be so confusing. Especially triple homophones such as: so, sew, sow. This is cool: I just figured out that Microsoft Word seems to hate homophones, it is underlining all kinds of stuff with squiggly lines write now. One guy on the Web<\/a> has collected 441 of the things; one nicety about such a collection is that it does not occupy as much space as a book collection or a car collection.)<\/p>\n

Often when working with Excel from within a scripting language, we tend to use the Excel Automation Model<\/a>. Using the Excel Automation Model generally involves creating an instance of the Excel.Application<\/a> object. This would look something like the script seen here: <\/p>\n

$strPath=\"c:\\data\\ScriptingGuys\\Servers.xls\"\n$objExcel=New-Object -ComObject Excel.Application\n$objExcel.Visible=$false\n$WorkBook=$objExcel.Workbooks.Open($strPath)\n$worksheet = $workbook.sheets.item(\"ServerList\")\n$intRowMax =  ($worksheet.UsedRange.Rows).count\n$Columnnumber = 1\n\nfor($intRow = 2 ; $intRow -le $intRowMax ; $intRow++)\n{\n $name = $worksheet.cells.item($intRow,$ColumnNumber).value2\n \"Querying $name ...\"\n  Get-WmiObject -Class win32_bios -computername $name\n   }\n$objexcel.quit()\n<\/pre>\n
But, FE, you specifically stated you did not want to use the Excel object model to query the spread sheet. You are then left with using Active X Data Objects (ADO). There are two flavors of ADO: the classic COM ADO you may have used in VBScript, and ADO.NET. In general, the ADO.NET flavor is faster and provides more options. With both the COM version of ADO and ADO.NET you will need to specify a provider. In some cases, these provider names will be the same. In other cases, you will find providers for a specific flavor of ADO.<\/p>\n
In the script we create two objects. The first is the System.Data.OleDb.OleDbConnection<\/b> object and the second is theSystem.Data.OleDb.OleDbCommand<\/b> object. You will note that both of the objects are in the System.Data.OleDb<\/b> namespace. Only the last portion of each name actually changes. These correspond to the connection and the command object we used in classic COM ADO. After the two objects are created, we associate the connection with the command object, open the connection, and use theExecuteReader<\/b> method from the command object. We then use the data reader to work our way through the data that is returned. We select the name<\/b> column, pass it to WMI, and close both data reader and connection. The script is shown here: <\/p>\n
$strFileName = \"C:\\Data\\scriptingGuys\\Servers.xls\"\n$strSheetName = 'ServerList$'\n$strProvider = \"Provider=Microsoft.Jet.OLEDB.4.0\"\n$strDataSource = \"Data Source = $strFileName\"\n$strExtend = \"Extended Properties=Excel 8.0\"\n$strQuery = \"Select * from [$strSheetName]\"\n\n$objConn = New-Object System.Data.OleDb.OleDbConnection(\"$strProvider;$strDataSource;$strExtend\")\n$sqlCommand = New-Object System.Data.OleDb.OleDbCommand($strQuery)\n$sqlCommand.Connection = $objConn\n$objConn.open()\n$DataReader = $sqlCommand.ExecuteReader()\n\nWhile($DataReader.read())\n{\n $ComputerName = $DataReader[0].Tostring() \n \"Querying $computerName ...\"\n Get-WmiObject -Class Win32_Bios -computername $ComputerName\n}  \n$dataReader.close()\n$objConn.close()\n<\/pre>\n
Let’s look at the script in a bit more detail. We begin the script by initializing a bunch of variables. The first is the path to the Excel spread sheet. (Note: We do not test to ensure this path actually exists. We left it out to reduce the complexity of the script. In a real script you would certainly want to verify the presence of the file before attempting to read the file. To do this in PowerShell you would use the Test-Path<\/a> cmdlet.) We then specify the sheet name. As seen in this figure, I always like to rename the Excel spreadsheets (I also delete the two extra sheets that I never seem to use as well):<\/p>\n
\"Excel <\/p>\n
 <\/p>\n
Next we need to specify the provider name, data source, and extended parameters for our connection. These are exactly the same as you would have used in classic COM ADO. Last, we need to specify our query. This takes the form of “Select * from [sheetname]”<\/b>. Note that the spreadsheet name must go inside square brackets (square brackets, not square pants). This section of the script is shown here: <\/p>\n
$strFileName = \"C:\\Data\\scriptingGuys\\Servers.xls\"\n$strSheetName = 'ServerList$'\n$strProvider = \"Provider=Microsoft.Jet.OLEDB.4.0\"\n$strDataSource = \"Data Source = $strFileName\"\n$strExtend = \"Extended Properties=Excel 8.0\"\n$strQuery = \"Select * from [$strSheetName]\"\n<\/pre>\n
The next thing we need to do is to create the two objects we will be using. When we create the OleDbConnection<\/b> object we specify the provider, data source, and the extended parameters to the New-Object<\/b> command. These values are called the constructor as it is used in constructing the connection<\/b> object. Next we need to create the command<\/b> object. The OleDbCommand<\/b> object accepts the query for its constructor. After we have these two objects created, we need to wire up the connection and the command, open the connection, and use the ExecuteReader<\/b> method from the OleDbCommand<\/b> object to return our information. This section of the code is shown here: <\/p>\n
$objConn = New-Object System.Data.OleDb.OleDbConnection ` (\"$strProvider;$strDataSource;$strExtend\")\n$sqlCommand = New-Object System.Data.OleDb.OleDbCommand($strQuery)\n$sqlCommand.Connection = $objConn\n$objConn.open()\n$DataReader = $sqlCommand.ExecuteReader()\n<\/pre>\n
The object that comes back from the ExecuteReader<\/b> method is called a DataReader. To work with a DataReader, we need to use theRead<\/b> method. We use the While<\/b> statement that says as long as the DataReader is returning data, we will keep on reading. This line of code is shown here:<\/p>\n
While($DataReader.read())<\/pre>\n
Well, what are we going to do while we have data coming from the DataReader? We are going to take the first piece of data and turn it into a string. This will be our computer name from the spreadsheet. We then use it in a basic WMI query. To do the WMI query, we use the Get-WmiObject<\/b> cmdlet and give it the WMI class to query (Win32_Bios)<\/b> and the name of the computer to query (the one from the spreadsheet). This is seen here: <\/p>\n
$ComputerName = $DataReader[0].Tostring() \n \"Querying $computerName ...\"\n Get-WmiObject -Class Win32_Bios -computername $ComputerName\n<\/pre>\n
To be polite, we close out the DataReader, and we close our connection to the Excel spreadsheet. This is easy to do; we use the close<\/b>method as shown here: <\/p>\n
$dataReader.close()\n$objConn.close()\n<\/pre>\n
The results from this script are impressive because of the minimalistic approach to data return. With our background, we are trying to exhaust the blues whilst understating the induction of white (for all you art majors). This can clearly be seen in this figure:<\/p>\n
\"Query <\/p>\n
 <\/p>\n
See, FE, that was not too bad was it? This is just half of the equation. If we happen to have an Excel spreadsheet handy, we can use this method to query it. However, if you do not have one handy, we will need to write to the spreadsheet and populate it with data. We will do that next week. Until then, TTFN.<\/p>\n
Ed Wilson and Craig Liebendorfer, Scripting Guys<\/b><\/b><\/span><\/font><\/p>\n
<\/b><\/font><\/div>\n
<\/span><\/p>\n","protected":false},"excerpt":{"rendered":"
Hey, Scripting Guy! I have an Microsoft Office Excel spreadsheet with server names in it, and I would like to be able to use this in a Windows PowerShell script. The thing is, I do not have Microsoft Office or Excel installed on the server. How can I use this spread sheet without installing Office […]<\/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":[19,727,146,48,49,3,45],"class_list":["post-55093","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-activex-data-objects-ado","tag-ado-net","tag-databases","tag-microsoft-excel","tag-office","tag-scripting-guy","tag-windows-powershell"],"acf":[],"blog_post_summary":"
Hey, Scripting Guy! I have an Microsoft Office Excel spreadsheet with server names in it, and I would like to be able to use this in a Windows PowerShell script. The thing is, I do not have Microsoft Office or Excel installed on the server. How can I use this spread sheet without installing Office […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/55093","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=55093"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/55093\/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=55093"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=55093"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=55093"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}