Skip to content

Instantly share code, notes, and snippets.

@Bill-Stewart
Created May 24, 2024 14:58
Show Gist options
  • Save Bill-Stewart/b5e71b7ef5e063b683f878203646fc39 to your computer and use it in GitHub Desktop.
Save Bill-Stewart/b5e71b7ef5e063b683f878203646fc39 to your computer and use it in GitHub Desktop.
# Get-Uptime.ps1
# Written by Bill Stewart (bstewart AT iname.com)
#
# Outputs uptime for one or more computers. Uptime is determined by the
# LastBootUpTime property from the Win32_OperatingSystem WMI class.
#requires -version 3
<#
.SYNOPSIS
Outputs the last bootup time and uptime for one or more computers.
.DESCRIPTION
Outputs the last bootup time and uptime for one or more computers.
.PARAMETER ComputerName
One or more computer names. The default is the current computer. Wildcards are not supported.
.PARAMETER Credential
Specifies credentials that have permission to connect to the remote computer. This parameter is ignored for the current computer.
.OUTPUTS
PSObjects containing the computer name, the last bootup time, and the uptime.
#>
[CmdletBinding()]
param(
[Parameter(ValueFromPipeline,ValueFromPipelineByPropertyName)]
$ComputerName,
[Management.Automation.PSCredential]
$Credential
)
begin {
function Format-TimeSpan {
process {
"{0} d {1:00} h {2:00} m {3:00} s" -f $_.Days,$_.Hours,$_.Minutes,$_.Seconds
}
}
function Get-Uptime {
param(
[String]
$computerName,
[Management.Automation.PSCredential]
$credential
)
# In case pipeline input contains ComputerName property
if ( $computerName.ComputerName ) {
$computerName = $computerName.ComputerName
}
if ( (-not $computerName) -or ($computerName -eq ".") ) {
$computerName = [Net.Dns]::GetHostName()
}
$params = @{
"Class" = "Win32_OperatingSystem"
"ComputerName" = $computerName
"Namespace" = "root\CIMV2"
}
if ( $credential ) {
# Ignore -Credential for current computer
if ( $computerName -ne [Net.Dns]::GetHostName() ) {
$params.Add("Credential",$credential)
}
}
try {
$wmiOS = Get-WmiObject @params -ErrorAction Stop
}
catch {
Write-Error -Exception (New-Object $_.Exception.GetType().FullName `
(("Cannot connect to the computer '$computerName' due to the following error: '{0}'" -f
($_.Exception.Message -replace [Environment]::NewLine,'')),$_.Exception))
return
}
$lastBootTime = [Management.ManagementDateTimeConverter]::ToDateTime($wmiOS.LastBootUpTime)
[PSCustomObject] @{
"ComputerName" = $computerName
"LastBootTime" = $lastBootTime
"UpTime" = (Get-Date) - $lastBootTime | Format-TimeSpan
}
}
}
process {
if ( $ComputerName ) {
foreach ( $ComputerNameItem in $ComputerName ) {
Get-Uptime $ComputerNameItem $Credential
}
}
else {
Get-Uptime "."
}
}
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment