GetBIOS

1.3.3

GetBIOS.psm1

<#
.Synopsis
    The Get-BIOS function allows you to list BIOS settings from your local or a remote Dell computer.
    You can query BIOS for the following manufacturer: Dell, HP, Lenovo, Toshiba
.DESCRIPTION
    Allow you to list BIOS settings from your computer or a remote computer.
    You can query BIOS for the following manufacturer: Dell, HP, Lenovo, Toshiba.
     
    See below available parameters:
    -Computer: List BIOS settings of a remote computer
    -CSV_Path: Type the path of the CSV export
    -HTML_Path: Type the path of the HTML export
    -ShowDescription: Allows you to display a description column (for Dell only)
    -ShowGridView: Allows you to export result in out-gridview
 
.EXAMPLE
PS Root\> Get-BIOS
The command above will list BIOS settings of your local computer
 
.EXAMPLE
PS Root\> Get-BIOS -Computer "Computer1"
The command above will list BIOS settings of the remote computer called Computer1.
It will prompt fro your credentials to access to the remote computer.
 
.EXAMPLE
PS Root\> Get-BIOS -HTML_Path "c:\report\export.html" -showdescription
The command above will list BIOS settings and display the description column if computer is a Dell.
It will also export BIOS settings to HTML report.
 
.EXAMPLE
PS Root\> Get-BIOS -CSV_Path "c:\report\export.csv" -showdescription
The command above will list BIOS settings and display the description column if computer is a Dell.
It will also export BIOS settings to CSV report.
 
.NOTES
    Author: Damien VAN ROBAEYS - @syst_and_deploy - http://www.systanddeploy.com
#>




function Get-Bios
{
    [CmdletBinding()]
    Param(
            [Parameter(Mandatory=$false)]
            [string]$Computer,
            [string]$CSV_Path,            
            [string]$HTML_Path,            
            [switch]$ShowDescription,
            [switch]$ShowGridView                            
         )

    Begin
    {

        $Run_As_Admin = ([Security.Principal.WindowsPrincipal] [Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)
        If($Run_As_Admin -eq $False)
        {
            write-host ""
            write-host "########################################################" -Foreground yellow
            write-host " Please run the Get-Bios cmdlet with admin rights" -Foreground yellow
            write-host "########################################################" -Foreground yellow    
            write-host ""
            break        
        }
    
        Function Get_Dell_BIOS_Settings
            {
                $WarningPreference='silentlycontinue'
                If (Get-Module -ListAvailable -Name DellBIOSProvider)
                    {} 
                Else 
                    {
                        Install-Module -Name DellBIOSProvider -Force 
                    }
                get-command -module DellBIOSProvider | out-null
                $Script:Get_BIOS_Settings = get-childitem -path DellSmbios:\ | select-object category | 
                foreach {
                    get-childitem -path @("DellSmbios:\" + $_.Category)  | select-object attribute, currentvalue, Description, PossibleValues                
                } 
                
                $Script:Get_BIOS_Settings = $Get_BIOS_Settings |  % { New-Object psobject -Property @{
                    Setting = $_."attribute"
                    Value = $_."currentvalue"
                    Description = $_."Description"    
                    "Possible values" = $_."PossibleValues"                                                
                    }}             
                
                If($ShowDescription)
                    {
                        $Get_BIOS_Settings | select-object Setting, Value, Description, "Possible values"
                    }
                Else
                    {
                        $Get_BIOS_Settings | select-object Setting, Value, "Possible values"
                    }
            }        
    
    
        Function Get_HP_BIOS_Settings
            {
                $Script:Get_BIOS_Settings = Get-WmiObject -Namespace root/hp/instrumentedBIOS -Class hp_biosEnumeration -ErrorAction SilentlyContinue |  % { New-Object psobject -Property @{                
                    Setting = $_."Name"    
                    "Value" = $_."currentvalue"
                    "Possible Values" = $_."possiblevalues"                    
                    }}  | select-object Setting, "Current Value", "Possible Values"
                $Get_BIOS_Settings
            }

        Function Get_Lenovo_BIOS_Settings
            {
                $Script:Get_Available_Values = Get-WmiObject -Class Lenovo_GetBiosSelections -Namespace root\wmi
                $Script:Get_BIOS_Settings = gwmi -class Lenovo_BiosSetting -namespace root\wmi  | select-object currentsetting | Where-Object {$_.CurrentSetting -ne ""} |
                select-object @{label = "Setting"; expression = {$_.currentsetting.split(",")[0]}} , 
                @{label = "Value"; expression = {$_.currentsetting.split(",*;[")[1]}},
                @{label = "Possible values"; expression = {($Get_Available_Values.GetBiosSelections($_.currentsetting.split(",")[0])).Selections}}                                           
                $Get_BIOS_Settings
            }            
        
        Function Get_Toshiba_BIOS_Settings
            {
                Try
                    {
                        $Script:Get_BIOS_Settings = Get-WmiObject -NameSpace "root\wmi" -Query "SELECT * FROM QueryBiosSettings" |  % { New-Object psobject -Property @{                
                            Setting = $_."CurrentSetting"
                            Value = $_."Currentvalue"
                            }}  | select-object Setting, Value
                        $Get_BIOS_Settings
                    }
                Catch
                    {}
            }        

        If(($Computer -ne ""))
            {    
                $Script:Creds = get-credential
                $scriptblock = {(Get-WmiObject Win32_Computersystem).manufacturer}
                $Get_manufacturer = Invoke-Command -ComputerName $Computer -ScriptBlock $scriptblock -credential $Creds        
            }
        Else
            {
                $Get_manufacturer = (Get-WmiObject Win32_Computersystem).manufacturer
            }
    
        If($Get_manufacturer -like "*dell*")
            {
                $manufacturer = "Dell"
            }
        ElseIf($Get_manufacturer -like "*lenovo*")
            {
                $manufacturer = "Lenovo"
                If($ShowDescription)
                    {
                        write-warning "The parameter ShowDescription is not available for Lenovo devices"                    
                    }
            }
        ElseIf(($Get_manufacturer -like "*HP*") -or ($Get_manufacturer -like "*hewlet*"))
            {
                $manufacturer = "HP"
                If($ShowDescription)
                    {
                        write-warning "The parameter ShowDescription is not available for Lenovo devices"                    
                    }                
            }
        ElseIf($Get_manufacturer -like "*toshiba*")
            {
                $manufacturer = "Toshiba"
                If($ShowDescription)
                    {
                        write-warning "The parameter ShowDescription is not available for Lenovo devices"                    
                    }                
            }
        Else
            {
                write-host ""
                write-host "########################################################" -Foreground yellow
                write-host " Your manufacturer is not supported by the module" -Foreground yellow
                write-host " Supported manufacturer: Dell, HP, Lenovo, Toshiba" -Foreground yellow                
                write-host "########################################################" -Foreground yellow    
                write-host ""
                break
            }
    }
    
    Process
    {
        If($ShowGridView -eq $null)
            {
                write-host ""
                write-host "###################################################" -Foreground Cyan
                write-host " Your manufacturer is $manufacturer" -Foreground Cyan
                write-host "###################################################" -Foreground Cyan    
                write-host ""        
            }
            
       switch ($manufacturer)
       {
           'Dell'
           {
                If(($Computer -ne ""))
                    {
                        $Get_BIOS_Settings = Invoke-Command  -credential $Creds -ComputerName $Computer -ScriptBlock ${Function:Get_Dell_BIOS_Settings}                                                                         
                        $CompName = $Computer
                    }
                Else
                    {
                        $Get_BIOS_Settings = Get_Dell_BIOS_Settings
                        $CompName = $env:computername                        
                    }
                    
                If($CSV_Path -ne "")
                    {
                        $Get_BIOS_Settings | Select * -ExcludeProperty "Possible values" | export-csv $CSV_Path -notype #-Delimiter ";"
                    }
            
                If($ShowGridView)
                    {
                        $Get_BIOS_Settings | out-gridview                            
                    }
                Else
                    {
                        $Get_BIOS_Settings
                    }
                    
                If($HTML_Path -ne "")
                    {    
                        $Date = get-date                                
                        $AllDatas = $Get_BIOS_Settings | Select * -ExcludeProperty "Possible values"
                        If ($AllDatas -eq $null)
                            {
                                $Search = ""
                            }
                        Else
                            {
                                $Search = "
                                <p> Type a setting to check like bootsequence or secure boot or something else to check ...</p>
 
                                <input class='form-control' id='myInput' type='text' placeholder='Search..'>
                                "  
                            }

                        $head = '
                          <meta charset="utf-8">
                          <meta name="viewport" content="width=device-width, initial-scale=1">
                          <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/4.1.0/css/bootstrap.min.css">
                          <script src="https://ajax.googleapis.com/ajax/libs/jquery/3.3.1/jquery.min.js"></script>
                          <script src="https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.14.0/umd/popper.min.js"></script>
                          <script src="https://maxcdn.bootstrapcdn.com/bootstrap/4.1.0/js/bootstrap.min.js"></script>
                          '
                          
                        $Title = "
                        <p align='center' >
                        <img src="""" width='' height=''/>
                        <br><br>
                        <span class='text-primary font-weight-bold lead'>BIOS Settings on $CompName</span>
                        <br><span class=text-success font-italic>This document has been updated on $Date</span></p>
                        "

                        $Script = '
                        <script>
                        $(document).ready(function(){
                          $("#myInput").on("keyup", function() {
                            var value = $(this).val().toLowerCase();
                            $("#myTable tr").filter(function() {
                              $(this).toggle($(this).text().toLowerCase().indexOf(value) > -1)
                            });
                          });
                        });
                        </script>
                        '


                        $MyData = $Get_BIOS_Settings | Select * -ExcludeProperty "Possible values" |
                        ConvertTo-HTML `
                        -head $head -body "$title<br>$Search<br>$MyData<br>$Script"    > $HTML_Path     

                        $HTML = get-content $HTML_Path
                        If($ShowDescription)
                            {
                                $HTML.replace("<table>",'<table class="table table-striped table-sm">').replace("<tr><th>Setting</th><th>Value</th><th>Description</th></tr>",'<thead class="thead-dark"><tr><th>Setting</th><th>Value</th><th>Description</th></tr></thead><tbody id="myTable">').replace('</table>','</tbody></table>') | out-file -encoding ASCII $HTML_Path                            
                            }
                        Else
                            {
                                $HTML.replace("<table>",'<table class="table table-striped table-sm">').replace("<tr><th>Setting</th><th>Value</th></tr>",'<thead class="thead-dark"><tr><th>Setting</th><th>Value</th></tr></thead><tbody id="myTable">').replace('</table>','</tbody></table>') | out-file -encoding ASCII $HTML_Path                            
                            }                        
                        Invoke-Item $HTML_Path
                    }
           }
           'HP'
           {
             Try
                {
                    If(($Computer -ne ""))
                        {
                            $Get_BIOS_Settings = Invoke-Command  -credential $Creds -ComputerName $Computer -ScriptBlock ${Function:Get_HP_BIOS_Settings} 
                            $Get_BIOS_Settings    | select Setting, Value        
                            $CompName = $Computer                                                    
                        }
                    Else
                        {        
                            $Get_BIOS_Settings = Get_HP_BIOS_Settings
                            $CompName = $env:computername                                                    
                        }

                    If($CSV_Path -ne "")
                        {
                            $Get_BIOS_Settings | Select * -ExcludeProperty "Possible values" | export-csv $CSV_Path -notype -Delimiter ";" 
                        }                                
                    
                    If($ShowGridView)
                        {
                            $Get_BIOS_Settings | out-gridview                            
                        }
                    Else
                        {
                            $Get_BIOS_Settings
                        }

                    If($HTML_Path -ne "")
                    {    
                        $Date = get-date                                
                        $AllDatas = $Get_BIOS_Settings | Select * -ExcludeProperty "Possible values"
                        If ($AllDatas -eq $null)
                            {
                                $Search = ""
                            }
                        Else
                            {
                                $Search = "
                                <p> Type a setting to check like bootsequence or secure boot or something else to check ...</p>
 
                                <input class='form-control' id='myInput' type='text' placeholder='Search..'>
                                "  
                            }

                        $head = '
                          <meta charset="utf-8">
                          <meta name="viewport" content="width=device-width, initial-scale=1">
                          <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/4.1.0/css/bootstrap.min.css">
                          <script src="https://ajax.googleapis.com/ajax/libs/jquery/3.3.1/jquery.min.js"></script>
                          <script src="https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.14.0/umd/popper.min.js"></script>
                          <script src="https://maxcdn.bootstrapcdn.com/bootstrap/4.1.0/js/bootstrap.min.js"></script>
                          '
                          
                        $Title = "
                        <p align='center' >
                        <img src="""" width='' height=''/>
                        <br><br>
                        <span class='text-primary font-weight-bold lead'>BIOS Settings on $CompName</span>
                        <br><span class=text-success font-italic>This document has been updated on $Date</span></p>
                        "

                        $Script = '
                        <script>
                        $(document).ready(function(){
                          $("#myInput").on("keyup", function() {
                            var value = $(this).val().toLowerCase();
                            $("#myTable tr").filter(function() {
                              $(this).toggle($(this).text().toLowerCase().indexOf(value) > -1)
                            });
                          });
                        });
                        </script>
                        '

                        $MyData = $Get_BIOS_Settings | Select * -ExcludeProperty "Possible values" |
                        ConvertTo-HTML `
                        -head $head -body "$title<br>$Search<br>$MyData<br>$Script"    > $HTML_Path     
                                                
                        $HTML = get-content $HTML_Path                                                
                        If($ShowDescription)
                            {
                                $HTML.replace("<table>",'<table class="table table-striped table-sm">').replace("<tr><th>Setting</th><th>Value</th><th>Description</th></tr>",'<thead class="thead-dark"><tr><th>Setting</th><th>Value</th><th>Description</th></tr></thead><tbody id="myTable">').replace('</table>','</tbody></table>') | out-file -encoding ASCII $HTML_Path                            
                            }
                        Else
                            {
                                $HTML.replace("<table>",'<table class="table table-striped table-sm">').replace("<tr><th>Setting</th><th>Value</th></tr>",'<thead class="thead-dark"><tr><th>Setting</th><th>Value</th></tr></thead><tbody id="myTable">').replace('</table>','</tbody></table>') | out-file -encoding ASCII $HTML_Path                            
                            }    
                        Invoke-Item $HTML_Path                                        
                    }
                            
                }    
            Catch
                {
                    Write-Warning -Message "An error occured while getting BIOS settings"
                }
                    
           }
           'Lenovo'
           {
             Try
                {
                    If(($Computer -ne ""))
                        {
                            $Get_BIOS_Settings = Invoke-Command  -credential $Creds -ComputerName $Computer -ScriptBlock ${Function:Get_Lenovo_BIOS_Settings}         
                            $Get_BIOS_Settings = $Get_BIOS_Settings    | select Setting, Value    -ExcludeProperty PSComputerName, RunspaceID, PSShowComputerName                                                                             
                            $CompName = $Computer                        
                        }
                    Else
                        {        
                            $Get_BIOS_Settings = Get_Lenovo_BIOS_Settings
                            $CompName = $env:computername                            
                        }
                        
                    If($CSV_Path -ne "")
                        {
                            # $Get_BIOS_Settings | export-csv $CSV_Path -notype -Delimiter ";"
                            $Get_BIOS_Settings | Select * -ExcludeProperty "Possible values" | export-csv $CSV_Path -notype #-Delimiter ";"
                        }
                    
                    If($ShowGridView)
                        {
                            $Get_BIOS_Settings | out-gridview                            
                        }
                    Else
                        {
                            $Get_BIOS_Settings
                        }

                    If($HTML_Path -ne "")
                    {    
                        $Date = get-date                                
                        # $AllDatas = $Get_BIOS_Settings
                        $AllDatas = $Get_BIOS_Settings | Select * -ExcludeProperty "Possible values"                        
                        If ($AllDatas -eq $null)
                            {
                                $Search = ""
                            }
                        Else
                            {
                                $Search = "
                                <p> Type a setting to check like boot sequence, secure boot or something else to check ...</p>
 
                                <input class='form-control' id='myInput' type='text' placeholder='Search..'>
                                "  
                            }

                        $head = '
                          <meta charset="utf-8">
                          <meta name="viewport" content="width=device-width, initial-scale=1">
                          <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/4.1.0/css/bootstrap.min.css">
                          <script src="https://ajax.googleapis.com/ajax/libs/jquery/3.3.1/jquery.min.js"></script>
                          <script src="https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.14.0/umd/popper.min.js"></script>
                          <script src="https://maxcdn.bootstrapcdn.com/bootstrap/4.1.0/js/bootstrap.min.js"></script>
                          '
                          
                        $Title = "
                        <p align='center' >
                        <img src="""" width='' height=''/>
                        <br><br>
                        <span class='text-primary font-weight-bold lead'>BIOS Settings on $CompName</span>
                        <br><span class=text-success font-italic>This document has been updated on $Date</span></p>
                        "

                        $Script = '
                        <script>
                        $(document).ready(function(){
                          $("#myInput").on("keyup", function() {
                            var value = $(this).val().toLowerCase();
                            $("#myTable tr").filter(function() {
                              $(this).toggle($(this).text().toLowerCase().indexOf(value) > -1)
                            });
                          });
                        });
                        </script>
                        '


                        # $MyData = $Get_BIOS_Settings |
                        $MyData = $Get_BIOS_Settings | Select * -ExcludeProperty "Possible values" |                                                
                        ConvertTo-HTML -head $head -body "$title<br>$Search<br>$MyData<br>$Script" > $HTML_Path     

                        $HTML = get-content $HTML_Path                                                
                        If($ShowDescription)
                            {
                                $HTML.replace("<table>",'<table class="table table-striped table-sm">').replace("<tr><th>Setting</th><th>Value</th><th>Description</th></tr>",'<thead class="thead-dark"><tr><th>Setting</th><th>Value</th><th>Description</th></tr></thead><tbody id="myTable">').replace('</table>','</tbody></table>') | out-file -encoding ASCII $HTML_Path                            
                            }
                        Else
                            {
                                $HTML.replace("<table>",'<table class="table table-striped table-sm">').replace("<tr><th>Setting</th><th>Value</th></tr>",'<thead class="thead-dark"><tr><th>Setting</th><th>Value</th></tr></thead><tbody id="myTable">').replace('</table>','</tbody></table>') | out-file -encoding ASCII $HTML_Path                            
                            }    
                        Invoke-Item $HTML_Path                    
                    }                                
                }
            Catch
                {
                    Write-Warning -Message "An error occured while getting BIOS settings"
                }
           }
           
           'Toshiba'
           {
             Try
                {
                    If(($Computer -ne ""))
                        {
                            $Get_BIOS_Settings = Invoke-Command  -credential $Creds -ComputerName $Computer -ScriptBlock ${Function:Get_Toshiba_BIOS_Settings}         
                            $Get_BIOS_Settings    | select Setting, Value    
                            $CompName = $Computer                                                    
                        }
                    Else
                        {
                            $CompName = $env:computername                                                
                            $Get_BIOS_Settings = Get_Toshiba_BIOS_Settings
                            If($CSV_Path -ne "")
                                {
                                    $Get_BIOS_Settings | export-csv $CSV_Path -notype -Delimiter ";"
                                }
                            
                            If($ShowGridView)
                                {
                                    $Get_BIOS_Settings | out-gridview                            
                                }
                            Else
                                {
                                    $Get_BIOS_Settings
                                }

                            If($HTML_Path -ne "")
                            {    
                                $Date = get-date                                
                                $AllDatas = $Get_BIOS_Settings 
                                If ($AllDatas -eq $null)
                                    {
                                        $Search = ""
                                    }
                                Else
                                    {
                                        $Search = "
                                        <p> Type a setting to check like bootsequence or secure boot or something else to check ...</p>
 
                                        <input class='form-control' id='myInput' type='text' placeholder='Search..'>
                                        "  
                                    }

                                $head = '
                                  <meta charset="utf-8">
                                  <meta name="viewport" content="width=device-width, initial-scale=1">
                                  <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/4.1.0/css/bootstrap.min.css">
                                  <script src="https://ajax.googleapis.com/ajax/libs/jquery/3.3.1/jquery.min.js"></script>
                                  <script src="https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.14.0/umd/popper.min.js"></script>
                                  <script src="https://maxcdn.bootstrapcdn.com/bootstrap/4.1.0/js/bootstrap.min.js"></script>
                                  '
                                  
                                $Title = "
                                <p align='center' >
                                <img src="""" width='' height=''/>
                                <br><br>
                                <span class='text-primary font-weight-bold lead'>BIOS Settings on $CompName</span>
                                <br><span class=text-success font-italic>This document has been updated on $Date</span></p>
                                "

                                $Script = '
                                <script>
                                $(document).ready(function(){
                                  $("#myInput").on("keyup", function() {
                                    var value = $(this).val().toLowerCase();
                                    $("#myTable tr").filter(function() {
                                      $(this).toggle($(this).text().toLowerCase().indexOf(value) > -1)
                                    });
                                  });
                                });
                                </script>
                                '


                        $MyData = $Get_BIOS_Settings |
                        ConvertTo-HTML `
                        -head $head -body "$title<br>$Search<br>$MyData<br>$Script"    > $HTML_Path     
                                
                        $HTML = get-content $HTML_Path                                                
                        If($ShowDescription)
                            {
                                $HTML.replace("<table>",'<table class="table table-striped table-sm">').replace("<tr><th>Setting</th><th>Value</th><th>Description</th></tr>",'<thead class="thead-dark"><tr><th>Setting</th><th>Value</th><th>Description</th></tr></thead><tbody id="myTable">').replace('</table>','</tbody></table>') | out-file -encoding ASCII $HTML_Path                            
                            }
                        Else
                            {
                                $HTML.replace("<table>",'<table class="table table-striped table-sm">').replace("<tr><th>Setting</th><th>Value</th></tr>",'<thead class="thead-dark"><tr><th>Setting</th><th>Value</th></tr></thead><tbody id="myTable">').replace('</table>','</tbody></table>') | out-file -encoding ASCII $HTML_Path                            
                            }    
                        Invoke-Item $HTML_Path                                        
                            }
                        }
                }
            Catch
                {
                    Write-Warning -Message "An error occured while getting BIOS settings"
                }
            }
        }
    }
    End
        {
        }
}