Comment utiliser PowerShell pour comparer l’heure système avec celle des serveurs NTP ?

La synchronisation temporelle est un élément essentiel de l’informatique. Veiller à ce que les appareils d’un réseau aient des temps congruents est vital pour diverses fonctionnalités et protocoles de sécurité. Cet article présente un script PowerShell conçu pour comparer l’heure système avec celle d’un serveur NTP, en signalant si la différence dépasse un certain seuil.

Contexte

Avec l’évolution des infrastructures informatiques modernes, l’importance de la précision du temps s’est amplifiée. Des disparités, même aussi minimes que quelques secondes, peuvent faire des ravages, en provoquant des anomalies dans les applications ou en compromettant la sécurité. Les professionnels de l’informatique et les fournisseurs de services gérés (MSP) doivent assurer une synchronisation précise de l’heure entre les appareils. Notre script sert d’outil pour repérer les divergences.

Le script

#Requires -Version 5.1

<#
.SYNOPSIS
    Compares the local system time to an NTP server, returning an exit code of 0 if less than a 2 minute difference or 1 if more than 2 minute difference.
.DESCRIPTION
    Compares the local system time to an NTP server, returning an exit code of 0 if less than a 2 minute difference or 1 if more than 2 minute difference.
.EXAMPLE
    No parameters needed
    The maximum acceptable time difference of 2 minute.
.EXAMPLE
    -Max 5
    The maximum acceptable time difference of 5 minute.
.EXAMPLE
    -NtpServer "pool.ntp.org"
    The maximum acceptable time difference of 2 minute, but uses the ntp.org's pool and use the time server pool "pool.ntp.org".
    Alterative pools:
    time.google.com
    time.cloudflare.com
    time.facebook.com
    time.apple.com
    time.nist.gov
.OUTPUTS
    None
.NOTES
    Minimum OS Architecture Supported: Windows 10, Windows Server 2016
    Exit code 1: If the time is off more than Max
    Exit code 0: If the time is off less than or equal to Max
    Release Notes:
    Initial Release
By using this script, you indicate your acceptance of the following legal terms as well as our Terms of Use at https://www.ninjaone.com/terms-of-use.
    Ownership Rights: NinjaOne owns and will continue to own all right, title, and interest in and to the script (including the copyright). NinjaOne is giving you a limited license to use the script in accordance with these legal terms. 
    Use Limitation: You may only use the script for your legitimate personal or internal business purposes, and you may not share the script with another party. 
    Republication Prohibition: Under no circumstances are you permitted to re-publish the script in any script library or website belonging to or under the control of any other software provider. 
    Warranty Disclaimer: The script is provided “as is” and “as available”, without warranty of any kind. NinjaOne makes no promise or guarantee that the script will be free from defects or that it will meet your specific needs or expectations. 
    Assumption of Risk: Your use of the script is at your own risk. You acknowledge that there are certain inherent risks in using the script, and you understand and assume each of those risks. 
    Waiver and Release: You will not hold NinjaOne responsible for any adverse or unintended consequences resulting from your use of the script, and you waive any legal or equitable rights or remedies you may have against NinjaOne relating to your use of the script. 
    EULA: If you are a NinjaOne customer, your use of the script is subject to the End User License Agreement applicable to you (EULA).
#>

[CmdletBinding()]
param (
    [Parameter()]
    [int]
    $Max = 2,
    [Parameter()]
    [string]
    $NtpServer = "time.windows.com"
)

begin {}
process {
    Write-Host "Using NTP server($NtpServer) to get time."
    $TimeSample = w32tm.exe /StripChart /Computer:"$NtpServer" /DataOnly /Samples:1
    $Diff = $($($TimeSample | Select-Object -Last 1) -split ', ' | Select-Object -Last 1) -replace '+' -replace '-'
    $TimeScale = $Diff -split '' | Select-Object -Last 1 -Skip 1

    # Convert to minutes
    $Diff = switch ($TimeScale) {
        "s" { [double]$($Diff -replace 's') / 60 }
        "m" { [double]$($Diff -replace 'm') }
        "h" { [double]$($Diff -replace 'h') * 60 * 60 }
        "d" { [double]$($Diff -replace 'd') * 60 * 60 * 24 }
        Default {}
    }
    Write-Host "Time Difference between NTP server and local system: $($([Math]::Round($Diff,2))) minutes"

    if ($Max -lt 0) {
        # If Max is negative then flip the sign to positive
        $Max = 0 - $Max
    }

    # Only output this if -Verbose is used
    Write-Verbose "$($Diff) minutes > $Max minutes = $($Diff -gt $Max)"
    # Assuming that $Max and $Diff are positive
    if (
        $Diff -gt $Max
    ) {
        # If time difference > $Max then return exit code of 1
        Write-Host "Time is over the maximum minutes of $Max."
        exit 1
    }
    else {
        # If time difference < $Max then return exit code of 0
        Write-Host "Time is under the maximum minutes of $Max."
        exit 0
    }
}
end {}

 

Description détaillée

• Cmdlet Binding et paramètres: Le script utilise l’attribut CmdletBinding, ce qui lui permet d’être utilisé comme cmdlet et d’exploiter les fonctionnalités intégrées de PowerShell. Deux paramètres sont déclarés : $Max, la différence de temps maximale acceptable (2 minutes par défaut), et $NtpServer, le serveur à vérifier (time.windows.com par défaut).
• Bloc “process”: La logique principale est exécutée ici.
• Il récupère le décalage horaire à l’aide de w32tm.exe, un outil de ligne de commande Windows.
• Il analyse le temps obtenu, en discernant la différence et son échelle (secondes, minutes, etc.).
• Il convertit le décalage horaire en minutes.
• Compare la différence calculée à $Max et renvoie le code de sortie approprié.

Cas d’utilisation potentiels

Imaginez un professionnel de l’informatique qui supervise un vaste réseau d’appareils au sein d’une entreprise. Il a observé des anomalies dans les applications enregistrant des actions horodatées. Pour établir un diagnostic, il déploie ce script afin de repérer les appareils présentant des différences de temps significatives. Les résultats obtenus leur permettent de procéder aux ajustements nécessaires.

Comparaisons

Bien qu’il existe des outils basés sur une interface graphique et des applications tierces qui offrent des fonctions de synchronisation du temps, ce script se distingue par sa simplicité et son adaptabilité. Il peut être intégré dans les flux de travail informatiques ou les outils d’automatisation existants, ce qui en fait une option polyvalente.

FAQ

• Puis-je utiliser différents serveurs NTP ?
  Oui, le script fournit un serveur par défaut, mais avec le paramètre $NtpServer, vous pouvez spécifier un autre serveur.
• Que se passe-t-il si je souhaite définir un autre seuil ?
  Modifiez le paramètre $Max pour qu’il corresponde au nombre de minutes souhaité.
• Le script est-il seulement pour Windows ?
  Le script fourni est conçu pour Windows, en particulier les versions 10 et Server 2016.

Implications

Les décalages horaires peuvent sembler anodins, mais ils peuvent avoir des conséquences considérables. Des horodatages différents peuvent compromettre l’intégrité des données, affecter les tâches planifiées et créer des vulnérabilités. Les attaquants peuvent exploiter les lacunes temporelles, c’est pourquoi des contrôles réguliers à l’aide d’outils tels que ce script sont essentiels pour la sécurité informatique.

Recommandations

• Exécutez le script à intervalles réguliers pour assurer une surveillance continue.
• Vérifiez toujours la validité du serveur NTP utilisé.
• En cas de divergences, il convient d’en rechercher la cause initiale, car elles peuvent être le signe de problèmes sous-jacents plus importants.

Conclusion

Bien que ces scripts soient inestimables, une plateforme complète comme NinjaOne peut améliorer votre gestion informatique. Intégrant des contrôles, une surveillance et une remédiation automatisés, NinjaOne peut compléter des outils tels que notre script PowerShell, garantissant que votre infrastructure reste à la fois fonctionnelle et sécurisée.