Refactor Install-Dependencies to only install or update as needed unless Force is used.

Author: SamErde

build/Install-Dependencies.ps1

@@ -19,47 +19,59 @@ param(
     $Force
 )
 
-# Get module settings from the relevant ModuleSettings.json file.
+# Get module settings from the relevant ModuleSettings.json file or a file that is manually specified.
 if ($ModuleSettingsPath) {
     $SettingsPath = $ModuleSettingsPath
 } else {
     $SettingsPath = "$PSScriptRoot/../module/$ModuleName/config/ModuleSettings.json"
 }
+
+Write-Host "Getting module settings from: '$SettingsPath'" -ForegroundColor Cyan
 $ModuleSettings = Get-Content -Path $SettingsPath | ConvertFrom-Json
-$RequiredVersion = $ModuleSettings.destinationModuleVersion
+$SourceModule = $ModuleSettings.sourceModule
+$DependencyRequiredVersion = $ModuleSettings.destinationModuleVersion
 
-# Do not check for installed modules if -Force is specified.
-if ($Force) {
-    Write-Verbose 'Skipping the check for installed prerequisites. Forcing the installation of all required modules.'
-} else {
-    Write-Verbose 'Checking installed modules for required dependencies.'
-    $InstalledModules = Get-Module -ListAvailable -Verbose:$false | Group-Object -Property Name
+# Get the names of the source and destination modules from the ModuleSettings.json file.
+[string[]]$ModuleNames = (($ModuleSettings.destinationModuleName) + $SourceModule).Split()
+
+Write-Host 'Checking for installed source and dependency modules...' -ForegroundColor Cyan
+$InstalledModules = foreach ( $Module in $ModuleNames ) {
+    Get-Module -Name $Module -ListAvailable -Verbose:$false | Sort-Object Name
 }
 
-# Install the AzureAD module.
-$SourceModule = $ModuleSettings.SourceModule
-if (($InstalledModules.Name -contains $SourceModule) -and -not $Force) {
-    Write-Verbose "Checking for updates to the '$SourceModule' module."
-} else {
-    Write-Verbose("Installing Module: $sourceModule")
+# Check if the source module is installed and then install it or update it.
+$IsSourceInstalled = $InstalledModules.Name -contains $SourceModule
+if (
+    (-not $IsSourceInstalled) -or
+    ($IsSourceInstalled -and $Force.IsPresent)
+) {
+    Write-Host "Installing Module: '$SourceModule'" -ForegroundColor Green
     try {
-        Install-Module $sourceModule -Scope CurrentUser -Force -AllowClobber
+        Install-Module $SourceModule -Scope CurrentUser -Force -AllowClobber
     } catch {
-        Write-Error "Failed to install the $sourceModule module. Error: $_"
+        Write-Error "Failed to install the '$SourceModule' module. Error: $_"
     }
 }
 
-# Install the required module dependencies if missing the required version or if -Force.
-foreach ($moduleName in $ModuleSettings.destinationModuleName) {
-    $InstalledModuleReference = $InstalledModules.Where({ $_.Name -eq $moduleName })
-    if (-not $InstalledModuleReference -or $Force) {
-        Write-Verbose "Installing version $RequiredVersion of $moduleName"
+# Install or update the destination modules specified in the ModuleSettings.json file.
+foreach ($DestinationModuleName in $ModuleSettings.destinationModuleName) {
+    $IsDependencyInstalled = $InstalledModules.Name -contains $DestinationModuleName
+    if (
+        # Force installation if the module is not installed or if the Force switch is present.
+        (-not $IsDependencyInstalled) -or ($IsDependencyInstalled -and $Force.IsPresent)
+    ) {
+        Write-Host "Installing Module: '$DestinationModuleName'" -ForegroundColor Green
+        try {
+            Install-Module $DestinationModuleName -RequiredVersion $DependencyRequiredVersion -Scope CurrentUser -Force -AllowClobber
+        } catch {
+            Write-Error "Failed to install the '$DestinationModuleName' module. Error: $_"
+        }
+    } else {
+        Write-Host "Updating Module: '$DestinationModuleName'" -ForegroundColor Green
         try {
-            Install-Module $moduleName -Scope CurrentUser -RequiredVersion $RequiredVersion -Force -AllowClobber
+            Update-Module -Name $DestinationModuleName -RequiredVersion $DependencyRequiredVersion -ErrorAction SilentlyContinue
         } catch {
-            Write-Error "Failed to install module $moduleName ${RequiredVersion}. Error: $_"
+            Write-Warning "Failed to update module '$DestinationModuleName' to version ${RequiredVersion}. Error: $_"
         }
-    } elseif ($InstalledModuleReference.Group.Version -contains $RequiredVersion) {
-        Write-Verbose "Found version $RequiredVersion of $moduleName"
     }
 }