PublishPsGalleryModule.ps1
|
#requires -Modules PowerShellGet $ReleaseNotes =@' Get-NtpTime Chris Warwick, @cjwarwickps, September 2015. v1.1 release to the PowerShell Gallery. This module contains a single PS Function 'Get-NtpTime' which sends an NTP request to a specified NTP server and decodes the returned raw NTP packet. The function will connect to pool.ntp.org if no server is specified. I originally wrote this script to check NTP responses from Windows Domain Controllers - but it works with any NTP server. See rfc-1305: http://www.faqs.org/rfcs/rfc1305.html Refer to the PowerShell help and additional background information included in the module for further details. .PARAMETER Server The NTP Server to contact. Uses pool.ntp.org by default. .PARAMETER MaxOffset The maximum acceptable offset between the local clock and the NTP Server, in milliseconds. The script will throw an exception if the time difference exceeds this value (on the assumption that the returned time may be incorrect). Default = 10000 (10s). .PARAMETER NoDns (Switch) If specified do not attempt to resolve Version 3 Secondary Server ReferenceIdentifiers. .EXAMPLE Get-NtpTime uk.pool.ntp.org Gets time from the specified server. .EXAMPLE Get-NtpTime | fl * Get time from default server (pool.ntp.org) and displays all output object attributes. .EXAMPLE Get-NtpTime DC01.company.org Get time from a domain controller. Usage: PS:\> Get-NtpTime NtpServer : pool.ntp.org NtpTime : 21/09/2015 12:17:26 OffsetSeconds : -0.009 NtpVersionNumber : 3 Mode_text : server Stratum : 2 ReferenceIdentifier : 195.66.241.2 <ntp0.linx.net> PS:\> Get-NtpTime -Server uk.pool.ntp.org | Format-List * NtpServer : uk.pool.ntp.org NtpTime : 21/09/2015 12:18:23 Offset : -18.845458984375 OffsetSeconds : -0.019 Delay : 22.98193359375 t1ms : 3588751103158.74 t2ms : 3588751103151.39 t3ms : 3588751103151.43 t4ms : 3588751103181.77 t1 : 21/09/2015 12:18:23 t2 : 21/09/2015 12:18:23 t3 : 21/09/2015 12:18:23 t4 : 21/09/2015 12:18:23 LI : 0 LI_text : no warning NtpVersionNumber : 3 Mode : 4 Mode_text : server Stratum : 2 Stratum_text : secondary reference (via NTP or SNTP) PollIntervalRaw : 0 PollInterval : 00:00:01 Precision : -23 PrecisionSeconds : 1.19209289550781E-07 ReferenceIdentifier : 195.66.241.2 <ntp0.linx.net> RootDelay : 0.003143310546875 RootDispersion : 0.02679443359375 Raw : {28, 2, 0, 233, 0, 0, 0, 206, 0, 0, 6, 220, 195, 66, 241, 2, 213, 231, 252, 27...} Version History: V1.1 (This version) - Updated help to reflect usage against domain controllers - Removed default display format code from script and replaced with .ps1xml format file V1.0 (Initial PowerShell Gallery version) - Copy with updates from original script V0.9 (Initial Technet ScriptCenter version) V0.1-0.8 Dev versions '@ $Tags = @( 'NTP' 'PowerShell' 'SNTP' 'Network' 'Time' 'rfc1305' 'rfc2030' 'UDP' 'ps1xml' 'PsCustomObject' ) $PublishParams = @{ Name = 'NtpTime' NuGetApiKey = 'XXXXRedactedXXXX' ReleaseNotes = $ReleaseNotes Tags = $Tags ProjectUri = 'https://github.com/ChrisWarwick/PowerShell-NTP-Time' } Publish-Module @PublishParams # ...later # Find-Module NtpTime |