HelperFunctions

2.2.27

Public/Get-LastBootTime.ps1

function global:Get-LastBootTime
{
    <#
        .EXTERNALHELP HelperFunctions.psm1-Help.xml
    #>
    
    [CmdletBinding(DefaultParameterSetName = 'Default',
                SupportsShouldProcess = $true)]
    [OutputType([PSObject])]
    param
    (
    [Parameter(ParameterSetName = 'Default',
             Mandatory = $false,
             ValueFromPipeline = $true,
             ValueFromPipelineByPropertyName = $true,
             HelpMessage = 'Enter the name of the computer to check or pipe the input to the function')]
    [Alias('cn')]
    [string[]]$ComputerName,
    [Parameter(ParameterSetName = 'Default',
             Mandatory = $false,
             ValueFromPipeline = $true,
             ValueFromPipelineByPropertyName = $true,
             HelpMessage = 'Enter the PS credential object variable name')]
    [ValidateNotNull()]
    [Alias('Cred')]
    [System.Management.Automation.PSCredential]$Credential,
    [Parameter(ParameterSetName = 'Default',
             Mandatory = $false,
             ValueFromPipeline = $true,
             ValueFromPipelineByPropertyName = $true,
             HelpMessage = 'Enter the number of days past or pipe input')]
    [ValidateNotNullOrEmpty()]
    [int]$DaysPast
    )
    
    begin
    {
        if ($null -eq $PSBoundParameters['ComputerName'])
        {
            $ComputerName = $env:COMPUTERNAME
        }
        
        if (($PSBoundParameters.ContainsKey('DaysPast') -and ($null -ne $PSBoundParameters["DaysPast"])))
        {
            $TimePast = (Get-Date).AddDays(-$DaysPast)
        }
        else
        {
            $TimePast = (Get-Date).AddDays(-1)
        }
        #$Time = Get-Date
    }
    process
    {
        foreach ($Computer in $ComputerName)
        {
            if ($PSCmdlet.ShouldProcess($Computer))
            {
                $params1 = @{
                    ComputerName = $Computer
                    Count       = 1
                    Quiet       = $true
                    ErrorAction  = 'Stop'
                }
                
                if (($PSBoundParameters.ContainsKey("Credential")) -and ($null -ne $PSBoundParameters["Credential"]))
                {
                    $params1.Add('Credential', $Credential)
                }
                
                if ((Test-Connection @params1) -eq $true)
                {
                    $params2 = @{
                        ComputerName = $Computer
                        ErrorAction  = 'Stop'
                    }
                    
                    if (($PSBoundParameters.ContainsKey("Credential")) -and ($null -ne $PSBoundParameters["Credential"]))
                    {
                        $params2.Add('Credential', $Credential)
                    }
                    
                    try
                    {
                        if ($PSCmdlet.ShouldProcess($Computer))
                        {
                            $events = Get-WinEvent @params2 -FilterHashtable @{
                                LogName   = 'System';
                                ID         = '1074'
                                StartTime = $TimePast
                            }
                        }
                        
                    }
                    catch
                    {
                        [pscustomobject]@{
                            ComputerName = "There were no event ID 1074 events of $($Computer)"
                        }
                    }
                }
                else
                {
                    [pscustomobject]@{
                        ComputerName = "Unable to reach $($Computer)"
                    }
                }
            }
        }
    }
    end
    {
        if ($null -ne $events)
        {
            Write-Output $events
        }
    }
} #end function Get-LastBootTime