Public/Get-WinComputerUptime.ps1
|
function Get-WinComputerUptime { <# .EXTERNALHELP HelperFunctions.psm1-Help.xml #> [CmdletBinding(DefaultParameterSetName = 'ComputerParamSet', SupportsShouldProcess = $true)] [OutputType([System.Object[]], ParameterSetName='ComputerParamSet')] [OutputType([System.Object[]], ParameterSetName='CimParamSet')] param ( [Parameter(ParameterSetName = 'ComputerParamSet', Mandatory = $false, ValueFromPipeline = $true, ValueFromPipelineByPropertyName = $true, HelpMessage = 'Enter the FQDN of the computer to get uptime for')] [Alias ('CN', 'Computer', 'ServerName', 'Server', 'IP')] [ValidateNotNullOrEmpty()] [string[]] $ComputerName, [Parameter(ParameterSetName = 'ComputerParamSet', Mandatory = $false, HelpMessage = 'Enter the name of the PS credential object')] [ValidateNotNullOrEmpty()] [System.Management.Automation.PsCredential] [System.Management.Automation.Credential()] $Credential = [System.Management.Automation.PSCredential]::Empty, [Parameter(ParameterSetName = 'CimParamSet', Mandatory = $true, HelpMessage = 'Enter the CimSession variable name')] [ValidateNotNullOrEmpty()] [Alias ('CimSession')] [Microsoft.Management.Infrastructure.CimSession[]] $Session ) begin { [String]$dtmFormatString = "yyyy-MM-dd HH:mm:ss" $ns = 'root\CIMv2' $params = @{ NameSpace = $ns ErrorAction = 'Stop' } $results = @() } process { switch ($PSCmdlet.ParameterSetName) { "ComputerParamSet" { if ($PSBoundParameters.ContainsKey('ComputerName') -and ($null -ne $PSBoundParameters["ComputerName"]) -and ($PSBoundParameters["ComputerName"].Count -gt 1)) { $ComputerName = $ComputerName -split (",") } elseif ($PSBoundParameters.ContainsKey('ComputerName') -and ($null -ne $PSBoundParameters["ComputerName"]) -and ($PSBoundParameters["ComputerName"].Count -eq 1)) { $ComputerName = $PSBoundParameters["ComputerName"] } else { $ComputerName = [System.Net.Dns]::GetHostByName("LocalHost").HostName } $Query = "Select * from Win32_OperatingSystem" foreach ($Computer in $ComputerName) { $params.Add('ComputerName', $Computer) if ($PSCmdlet.ShouldProcess($Computer)) { try { $objOS = Get-CimInstance -Query $Query @params if ($null -ne $objOS) { $uptimeTimespan = New-TimeSpan -Start $objOS.LastBootUpTime.ToUniversalTime() -End $objOS.LocalDateTime.ToUniversalTime() $uptime = New-Object System.TimeSpan($uptimeTimespan.Days, $uptimeTimespan.Hours, $uptimeTimespan.Minutes, $uptimeTimespan.Seconds) $lastBootupTime = $objOS.LastBootUpTime.ToString($dtmFormatString) $lastBootupTimeUTC = $objOS.LastBootUpTime.ToUniversalTime().ToString($dtmFormatString) } } catch { $errorMessage = "{0}: {1}" -f $Error[0], $Error[0].InvocationInfo.PositionMessage Write-Error $errorMessage -ErrorAction Continue } } $result = [PSCustomObject]@{ Computer = $Computer Uptime = $uptime LastBootTimeUTC = $lastBootupTimeUTC LastBootTimeLocal = $lastBootupTime } $results += $result $params.Remove('ComputerName') } } "CimParamSet" { for ($i = 0; $i -lt $Session.Count; $i++) { Write-Output ("Session Name is: {0}" -f $Session[$i].Name) $params.Add('CimSession', $Session[$i]) $Query = "Select * from CIM_OperatingSystem" if ($PSCmdlet.ShouldProcess($Session[$i])) { try { $objOS = Get-CimInstance -Query $Query @params if ($null -ne $objOS) { $uptimeTimespan = New-TimeSpan -Start $objOS.LastBootUpTime.ToUniversalTime() -End $objOS.LocalDateTime.ToUniversalTime() $uptime = New-Object System.TimeSpan($uptimeTimespan.Days, $uptimeTimespan.Hours, $uptimeTimespan.Minutes, $uptimeTimespan.Seconds) $lastBootupTime = $objOS.LastBootUpTime.ToString($dtmFormatString) $lastBootupTimeUTC = $objOS.LastBootUpTime.ToUniversalTime().ToString($dtmFormatString) } } catch { $errorMessage = "{0}: {1}" -f $Error[0], $Error[0].InvocationInfo.PositionMessage Write-Error -Message $errorMessage -ErrorAction Continue } $result = [PSCustomObject]@{ Computer = $Session[$i].ComputerName Uptime = $uptime LastBootTimeUTC = $lastBootupTimeUTC LastBootTimeLocal = $lastBootupTime } $results += $result } $params.Remove('CimSession') } } } #end Switch } end { return $results } } #End function Get-WinComputerUptime |