{"id":50753,"date":"2010-04-05T00:01:00","date_gmt":"2010-04-05T00:01:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2010\/04\/05\/hey-scripting-guy-how-can-i-search-a-microsoft-excel-workbook-for-links-to-other-workbooks\/"},"modified":"2010-04-05T00:01:00","modified_gmt":"2010-04-05T00:01:00","slug":"hey-scripting-guy-how-can-i-search-a-microsoft-excel-workbook-for-links-to-other-workbooks","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/hey-scripting-guy-how-can-i-search-a-microsoft-excel-workbook-for-links-to-other-workbooks\/","title":{"rendered":"Hey, Scripting Guy! How Can I Search a Microsoft Excel Workbook for Links to Other Workbooks?"},"content":{"rendered":"

\"Bookmark<\/a> <\/p>\n

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

Hey, Scripting Guy! I have a user in our finance department that asked me today about using a Windows PowerShell script to identify Microsoft Excel workbooks that have links inside them to other Microsoft Excel workbooks. Frankly, I am not exactly sure what she is talking about, but I do think it is great that she asked me about Windows PowerShell. Can you help me out? I do not want this user to get all depressed the first time she attempts to do something with Windows PowerShell.<\/p>\n

— SV<\/p>\n

 <\/p>\n

\"Hey,Hello SV, <\/p>\n

Microsoft Scripting Guy Ed Wilson here. It has been many years since I created Microsoft Excel workbooks that contained links to other workbooks, or more accurately, links to spreadsheets in other workbooks. I believe I know the reason your user is asking for such a script, and that is because according to the Microsoft Excel online Help, there is no automated method of detecting such links. But if one of the workbooks becomes moved, renamed, or deleted, the workbook containing the link will not work properly. This is shown in the following image.<\/p>\n

\"Image<\/p>\n

 <\/p>\n

The link to a spreadsheet in another Microsoft Excel workbook looks something like this: =’C:fso[cdRoms.xlsx]Sheet1′!$A$1<\/b>. Therefore, it will be possible to write a Windows PowerShell script that will search a workbook for formulas that match that pattern. The Get-LinkedExcelSheets.ps1 script is an example of a script that does this. The complete Get-LinkedExcelSheets.ps1 script is shown here. <\/p>\n

Get-LinkedExcelSheets.ps1<\/p>\n

<\/strong><\/p>\n

$path = “C:fso”
$excelSheets = Get-Childitem -Path $path -Include *.xls,*.xlsx -Recurse
$excel = New-Object -comobject Excel.Application
$excel.visible = $false<\/p>\n

foreach($excelSheet in $excelSheets)
{
 <\/span>$workbook = $excel.Workbooks.Open($excelSheet)
 <\/span>“There are $($workbook.Sheets.count) sheets in $excelSheet”<\/p>\n

 <\/span>For($i = 1 ; $i -le $workbook.Sheets.count ; $i++)
 <\/span>{
  <\/span>$worksheet = $workbook.sheets.item($i)
  <\/span>“`tLooking for links on $($worksheet.name) worksheet”
  <\/span>$rowMax = ($worksheet.usedRange.rows).count
  <\/span>$columnMax = ($worksheet.usedRange.columns).count
  <\/span>For($row = 1 ; $row -le $rowMax ; $row ++)
  <\/span>{
   <\/span>For($column = 1 ; $column -le $columnMax ; $column ++)
    <\/span>{
     <\/span>[string]$formula = $workSheet.cells.item($row,$column).formula
     <\/span>if($formula -match “w?:\\w*\\[w*.xlsw?]”) {“`t`t$($formula)”}
    <\/span>} #end for $column
   <\/span>} #end for $row
  <\/span>$worksheet = $rowmax = $columnMax = $row = $column = $formula = $null
 <\/span>} #end for
 <\/span>$workbook.saved = $true
 <\/span>$workbook.close()
} #end foreach
 <\/span>
 <\/span>$excel.quit()
 <\/span>$excel = $null
 <\/span>[gc]::collect()
 <\/span>[gc]::WaitForPendingFinalizers()<\/p>\n

<\/font><\/font><\/p>\n

For more information about using Windows PowerShell with the Microsoft Excel automation model, refer to the Microsoft Excel articles<\/font><\/a> on the Hey, Scripting Guy! Blog.<\/p>\n

To illustrate working with linked Microsoft Excel spreadsheets, I created a couple of Microsoft Excel workbooks containing spreadsheets with links to other spreadsheets in other workbooks. This is shown in the following image.<\/p>\n

\"Image<\/p>\n

 <\/p>\n

The first thing to do in the Get-LinkedExcelSheets.ps1 script is to assign the path to the folder that contains Microsoft Excel workbooks. The path is assigned to the $path<\/b> variable. Next, use the Get-ChildItem<\/b> cmdlet to retrieve all of the Microsoft Excel spreadsheets. The include<\/b> parameter includes all of the legacy XLS workbooks as well as the new XLSX workbooks. The recurse<\/b> parameter is required to make the Get-ChildItem<\/b> cmdlet return all files that match the search criteria in the folder. This section of the script is shown here:<\/p>\n

$path = “C:fso”
$excelSheets = Get-Childitem -Path $path -Include *.xls,*.xlsx -Recurse<\/p>\n

<\/font><\/font><\/p>\n

Now it is time to create an instance of the Excel.Application<\/b> COM object. To do this, use the New-Object<\/b> cmdlet and specify the name of the COM object. The application object is the main object that is used when working with Microsoft Excel automation. Because there are possibly many Microsoft Excel workbooks in the folder, it is not desirable to have the Microsoft Excel application appearing and disappearing during the running of the script. Therefore, the visible<\/b> property from the Microsoft Excel application object is set to $false<\/b>. This is shown here:<\/p>\n

$excel = New-Object -comobject Excel.Application
$excel.visible = $false<\/p>\n

<\/font><\/font><\/p>\n

When the Excel.Application<\/b> object has been created, and the collection of Microsoft Excel workbooks has been generated, it is time to walk through the collection. To do this, use the ForEach<\/b> statement as shown here:<\/p>\n

foreach($excelSheet in $excelSheets)
{<\/p>\n

<\/font><\/font><\/p>\n

Inside the ForEach<\/b> statement, use the Open<\/b> method from the Workbooks<\/b> collection of the Excel.Application<\/b> object. Pass the path that is stored in the $excelSheet<\/b> variable to the Open<\/b> method, and store the returned workbook object in the $workbook<\/b> variable as shown here:<\/p>\n

 <\/span>$workbook = $excel.Workbooks.Open($excelSheet)<\/p>\n

<\/font><\/font><\/p>\n

The sheets<\/b> object, which is obtained from the workbook<\/b> object, contains the count<\/b> property that can be used to determine how many spreadsheets are contained in a Microsoft Excel workbook. This information is displayed in the Windows PowerShell console. A subexpression $() <\/b>is required to prevent the COM object from unraveling inside the double quotation marks. The subexpression forces the value of the expression to be processed before the string is displayed. This is shown here:<\/p>\n

 <\/span>“There are $($workbook.Sheets.count) sheets in $excelSheet”<\/p>\n

<\/font><\/font><\/p>\n

Now it is time to walk through the collection of spreadsheets. To do this, the For<\/b> statement is used as shown here:<\/p>\n

 <\/span>For($i = 1 ; $i -le $workbook.Sheets.count ; $i++)<\/p>\n

<\/font><\/font><\/p>\n

The item<\/b> method from the sheets<\/b> collection is used to retrieve a specific spreadsheet. Because the For<\/b> statement will continue to operate once for each of the total number of spreadsheets in the collection, the $i<\/b> variable is used to keep track of where the operation is within the collection. The worksheet<\/b> object is stored in the $worksheet<\/b> variable as shown here:<\/p>\n

 <\/span>{
  <\/span>$worksheet = $workbook.sheets.item($i)<\/p>\n

<\/font><\/font><\/p>\n

Next, a status message is displayed on the Windows PowerShell console. The `t<\/b> character is a special character that causes the text to tab over one stop. A subexpression is used to retrieve the name of the worksheet via the name<\/b> property. This is shown here:<\/p>\n

  <\/span>“`tLooking for links on $($worksheet.name) worksheet”<\/p>\n

<\/font><\/font><\/p>\n

Now the number of rows and columns that are used within the spreadsheet are calculated via the count<\/b> property of the range<\/b> object. The number of rows and the number of columns are assigned to variables as shown here:<\/p>\n

  <\/span>$rowMax = ($worksheet.usedRange.rows).count
  <\/span>$columnMax = ($worksheet.usedRange.columns).count<\/p>\n

<\/font><\/font><\/p>\n

For each used row and each used column, the value of the formula<\/b> property of the cell is retrieved and stored in the $formula<\/b> variable. The [string]<\/b> type is used to ensure the formula is returned as a string so that a regular expression pattern match can be used to look for linked spreadsheets. This is shown here:<\/p>\n

  <\/span>For($row = 1 ; $row -le $rowMax ; $row ++)
  <\/span>{
   <\/span>For($column = 1 ; $column -le $columnMax ; $column ++)
    <\/span>{
     <\/span>[string]$formula = $workSheet.cells.item($row,$column).formula<\/p>\n

<\/font><\/font><\/p>\n

The If<\/b> statement is used to see if the formula stored in the $formula<\/b> variable matches a particular regular expression pattern. The regular expression pattern is not particularly complicated, but it is a bit cumbersome. The regular expression pattern is shown here:<\/p>\n

w?:\\w*\\[w*.xlsw?]<\/p>\n

<\/font><\/font><\/p>\n

A useful breakdown of the pattern is shown in the following table.\n <\/p>\n\n\n\n\n\n\n\n\n\n
\n
\n

Regular expression<\/p>\n

<\/b><\/p>\n<\/div>\n<\/td>\n

\n
\n

Meaning<\/p>\n

<\/b><\/p>\n<\/div>\n<\/td>\n<\/tr>\n

\n
\n

w<\/p>\n<\/div>\n<\/td>\n

\n
\n

a word character [a-zA-Z_0-9]<\/p>\n<\/div>\n<\/td>\n<\/tr>\n

\n
\n

?<\/p>\n<\/div>\n<\/td>\n

\n
\n

one instance of preceding character<\/p>\n<\/div>\n<\/td>\n<\/tr>\n

\n
\n

: <\/p>\n<\/div>\n<\/td>\n

\n
\n

literal character<\/p>\n<\/div>\n<\/td>\n<\/tr>\n

\n
\n

\n<\/div>\n<\/td>\n

\n
\n

escapes a backslash<\/p>\n<\/div>\n<\/td>\n<\/tr>\n

\n
\n

\n<\/div>\n<\/td>\n

\n
\n

the backslash character<\/p>\n<\/div>\n<\/td>\n<\/tr>\n

\n
\n

w<\/p>\n<\/div>\n<\/td>\n

\n
\n

a word character [a-zA-Z_0-9]<\/p>\n<\/div>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n","protected":false},"excerpt":{"rendered":"

    Hey, Scripting Guy! I have a user in our finance department that asked me today about using a Windows PowerShell script to identify Microsoft Excel workbooks that have links inside them to other Microsoft Excel workbooks. Frankly, I am not exactly sure what she is talking about, but I do think it is […]<\/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":[48,49,3,45],"class_list":["post-50753","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-microsoft-excel","tag-office","tag-scripting-guy","tag-windows-powershell"],"acf":[],"blog_post_summary":"

    Hey, Scripting Guy! I have a user in our finance department that asked me today about using a Windows PowerShell script to identify Microsoft Excel workbooks that have links inside them to other Microsoft Excel workbooks. Frankly, I am not exactly sure what she is talking about, but I do think it is […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/50753","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=50753"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/50753\/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=50753"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=50753"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=50753"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}