Set-Date
Modifie l’heure système sur l’ordinateur à une heure que vous spécifiez.
Syntaxe
Date (Par défaut)
Set-Date
[-Date] <DateTime>
[-DisplayHint <DisplayHintType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Adjust
Set-Date
[-Adjust] <TimeSpan>
[-DisplayHint <DisplayHintType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet Set-Date de commande remplace la date et l’heure système de 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 objet DateTime ou 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 .
Vous devez disposer de droits d’administration pour modifier la date et l’heure du système. Sur Windows, démarrez PowerShell avec l’option Run en tant qu’administrateur.
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 Get-Date de commande 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 Adjust 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 qui Set-Date retourne.
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 transmettre l’objet $TDateTime à l’applet Set-Date de commande.
$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 New-TimeSpan de commande pour créer un objet TimeSpan avec un intervalle de 90 minutes et l’enregistre dans la $90mins variable.
La deuxième commande utilise le paramètre Ajuster pour Set-Date ajuster la date par la valeur de l’objet TimeSpan dans la $90mins variable.
$90mins = New-TimeSpan -Minutes 90
Set-Date -Adjust $90mins
5 : Passer à une date et une heure spécifiques
L’exemple suivant définit la date et l’heure sur une valeur spécifique.
PS> Get-Date
Monday, June 10, 2024 2:05:48 PM
PS> Set-Date '6/11/2024 2:05:48 PM'
Tuesday, June 11, 2024 2:05:48 PM
Paramètres
-Adjust
Spécifie la valeur pour laquelle cette applet de commande ajoute ou soustrait la date et l’heure actuelles. Vous pouvez taper un ajustement au format de date et d’heure standard pour vos paramètres régionaux ou utiliser le paramètre Adjust pour passer un objet TimeSpan à Set-Datepartir de New-TimeSpan .
Propriétés du paramètre
| Type: | TimeSpan |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
Adjust
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-Confirm
Vous invite à confirmer avant d’exécuter l’applet de commande.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | DateTime |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
Date
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | 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. -
Time- 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.
Propriétés du paramètre
| Type: | DisplayHintType |
| Valeur par défaut: | None |
| Valeurs acceptées: | Date, Time, DateTime |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
Entrées
DateTime
Vous pouvez diriger une date vers cette applet de commande.
Sorties
DateTime
Cette applet de commande 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 Confirm pour éviter les erreurs.
- Vous pouvez utiliser des méthodes .NET standard avec les objets DateTime et TimeSpan utilisés avec
Set-Date, tels que AddDays, AddMonths et FromFileTime. Pour plus d’informations, consultez DateTime Methods et TimeSpan Methods dans le SDK .NET.
