Created
May 24, 2024 14:58
-
-
Save Bill-Stewart/b5e71b7ef5e063b683f878203646fc39 to your computer and use it in GitHub Desktop.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
# 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