Partager via

Set-Date

  • Référence
Module:
Microsoft.PowerShell.Utility

Modifie l’heure système sur l’ordinateur à une heure que vous spécifiez.

Syntaxe

Set-Date
   [-Date] <DateTime>
   [-DisplayHint <DisplayHintType>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-Date
   [-Adjust] <TimeSpan>
   [-DisplayHint <DisplayHintType>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

L’applet de commande Set-Date modifie la date et l’heure système sur l’ordinateur par une date et une heure que vous spécifiez. Vous pouvez spécifier une nouvelle date et/ou heure en tapant une chaîne ou en passant un DateTime ou objet TimeSpan à Set-Date. Pour spécifier une nouvelle date ou heure, utilisez le paramètre Date. Pour spécifier un intervalle de modification, utilisez le paramètre Ajuster.

Exemples

Exemple 1 : Ajouter trois jours à la date système

Cette commande ajoute trois jours à la date système actuelle. Cela n’affecte pas le temps. La commande utilise le paramètre date pour spécifier la date.

L’applet de commande Get-Date retourne la date actuelle en tant qu’objet DateTime. La méthode AddDays de l’objet DateTime ajoute un nombre spécifié de jours (3) à l’objet DateTime actuel.

Set-Date -Date (Get-Date).AddDays(3)

Exemple 2 : Définir l’horloge système de 10 minutes

Cet exemple montre comment définir l’heure système actuelle de 10 minutes.

Le paramètre Ajuster vous permet de spécifier un intervalle de modification (moins dix minutes) au format de temps standard pour les paramètres régionaux.

Le paramètre DisplayHint indique à PowerShell d’afficher uniquement l’heure, mais n’affecte pas l’objet DateTime retourné par .

Set-Date -Adjust -0:10:0 -DisplayHint Time

Exemple 3 : Définir la date et l’heure sur une valeur de variable

Ces commandes modifient la date et l’heure système sur l’ordinateur local par la date et l’heure enregistrées dans la variable $T. La première commande obtient la date et la stocke dans $T.

La deuxième commande utilise le paramètre Date pour passer l’objet DateTime dans $T à l’applet de commande Set-Date.

$T = Get-Date
Set-Date -Date $T

Exemple 4 : Ajouter 90 minutes à l’horloge système

Ces commandes avancent l’heure système sur l’ordinateur local de 90 minutes.

La première commande utilise l’applet de commande New-TimeSpan pour créer un objet TimeSpan avec un intervalle de 90 minutes et l’enregistre dans la variable $90mins.

La deuxième commande utilise le paramètre Ajuster de Set-Date pour ajuster la date par la valeur de l’objet TimeSpan dans la variable $90mins.

$90mins = New-TimeSpan -Minutes 90
Set-Date -Adjust $90mins

Paramètres

-Adjust

Spécifie la valeur pour laquelle cette applet de commande ajoute ou soustrait la date et l’heure actuelles. peut taper un ajustement au format de date et d’heure standard pour vos paramètres régionaux ou utiliser le paramètre Ajuster pour passer un objet TimeSpan de New-TimeSpan à Set-Date.

Type:TimeSpan
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Date

Remplace la date et l’heure par les valeurs spécifiées. Vous pouvez taper une nouvelle date au format de date court et une heure au format d’heure standard pour vos paramètres régionaux. Vous pouvez également passer un objet DateTime à partir de Get-Date.

Si vous spécifiez une date, mais pas une heure, Set-Date remplace l’heure par minuit à la date spécifiée. Si vous spécifiez uniquement une heure, elle ne modifie pas la date.

Type:DateTime
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-DisplayHint

Spécifie quels éléments de la date et de l’heure sont affichés. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • Date : affiche uniquement la date.
  • heure : affiche uniquement l’heure.
  • dateTime : affiche la date et l’heure.

Ce paramètre affecte uniquement l’affichage. Il n’affecte pas l’objet DateTime qui Get-Date récupère.

Type:DisplayHintType
Valeurs acceptées:Date, Time, DateTime
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

DateTime

Vous pouvez diriger une date vers Set-Date.

Sorties

DateTime

Set-Date retourne un objet qui représente la date définie.

Notes

  • Utilisez cette applet de commande avec prudence lors de la modification de la date et de l’heure sur l’ordinateur. La modification peut empêcher l’ordinateur de recevoir des événements et des mises à jour à l’échelle du système déclenchés par une date ou une heure. Utilisez les paramètres WhatIf et Confirmer pour éviter les erreurs.

  • Vous pouvez utiliser des méthodes .NET standard avec les DateTime et objets TimeSpan utilisés avec , tels que AddDays, AddMonthset FromFileTime. Pour plus d’informations, consultez méthodes DateTime et

    méthodes TimeSpan dans le Kit de développement logiciel (SDK) .NET.