Set-RemoteComputerTime.ps1

19 Sep 2025

• Description
  • Purpose
  • Detailed Description
  • Usage
  • Notes
  • Script
  • Download
  • Report Issues

---

Description

Purpose

Function to correct wrong time and date on remote machines

Detailed Description

Set-RemoteComputerTime -ComputerName -Domain (default = )

Back to Top

Usage

Example 1

Set-RemoteComputerTime Computer01

Back to Top

Notes

Additional information about the function.

Back to Top

---

Script

Function Set-RemoteComputerTime {
	<#
		.SYNOPSIS
			Function to correct wrong time and date on remote machines

		.DESCRIPTION
			Set-RemoteComputerTime -ComputerName <Hostname> -Domain <domain> (default = )

		.EXAMPLE
			Set-RemoteComputerTime Computer01
		
		.OUTPUTS
			System.String
		
		.NOTES
			Additional information about the function.
	#>
	
	[CmdletBinding(DefaultParameterSetName = 'Default',
		HelpUri = 'https://github.com/BanterBoy')]
	[OutputType([string])]
	param
	(
		[Parameter(ParameterSetName = 'Default',
			Mandatory = $true,
			ValueFromPipeline = $true,
			ValueFromPipelineByPropertyName = $true,
			HelpMessage = 'Enter computer name or pipe input')]
		[Alias('cn')]
		[string[]]$ComputerName,
		[Parameter()]
		[ValidateNotNullOrEmpty()]
		[String]$Domain
	)
	try {
		$Computer = (Get-ADComputer $ComputerName -properties DNSHostname, description, OperatingSystem -server $Domain -ErrorAction stop)
		$AdCheck = $true
	}
	Catch {
		Write-Host -ForegroundColor Red "Machine $($ComputerName) not found in AD"
		$Computer = $_.Exception.Message
		$AdCheck = $false
	}
	# Check machine is online
	if ($True -eq $AdCheck) {
		$PathTest = Test-Connection -Computername $Computer.DNSHostname -BufferSize 16 -Count 1 -Quiet
	}
	if ($True -eq $PathTest) {
		Write-host -ForegroundColor Green "$($ComputerName) is online"
		$RemoteTimeAndDate = Invoke-Command -ComputerName $Computer.DNSHostname -ScriptBlock { return Get-Date -Format "dddd MM/dd/yyyy HH:mm" }
		$TimeAndDate = Get-date -Format "dddd MM/dd/yyyy HH:mm"
		if ($RemoteTimeAndDate -ne $TimeAndDate) {
			Write-Host -ForegroundColor RED "$($ComputerName) time is out"
			Write-Host -ForegroundColor RED "Remote Time - $($RemoteTimeAndDate)"
			Write-Host -ForegroundColor RED "Local Time - $($TimeAndDate)"
			$Continue = Read-Host -Prompt 'Do you wish to correct? -  Press Y to continue'
			if ("Y" -eq $Continue.ToUpper()) {
				Write-Warning -Message "Correcting time on $($ComputerName)"
				$TimeAndDate = Get-date
				$RemoteTimeAndDate = Invoke-Command -ComputerName $Computer.DNSHostname -ScriptBlock { Set-Date -Date $using:TimeAndDate
					return Get-Date -Format "dddd MM/dd/yyyy HH:mm" }
				if ($RemoteTimeAndDate -eq $TimeAndDate) {
					Write-Host -ForegroundColor Green "$($ComputerName) time was successfully corrected"
				}
				else {
					Write-Host -ForegroundColor RED "$($ComputerName) issue correcting time"
					Write-Host -ForegroundColor RED "Remote Time - $($RemoteTimeAndDate)"
					Write-Host -ForegroundColor RED "Remote Time - $($TimeAndDate)"
				}
			}
	
		}
		else {
			Write-Host -ForegroundColor Green "$($ComputerName) time is correct"
		}
	}
	else {
		Write-host -ForegroundColor Red "$($ComputerName) is offline"
	}
}

Back to Top

Download

Please feel free to copy parts of the script or if you would like to download the entire script, simply click the download button. You can download the complete repository in a zip file by clicking the Download link in the menu bar on the left hand side of the page.

---

Report Issues

You can report an issue or contribute to this site on GitHub. Simply click the button below and add any relevant notes. I will attempt to respond to all issues as soon as possible.

Issue

---

Back to Top