Set-Date
Définit l'heure système sur l'ordinateur sur une heure que vous spécifiez.
Syntax
Set-Date
[-Date] <DateTime>
[-DisplayHint <DisplayHintType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-Date
[-Adjust] <TimeSpan>
[-DisplayHint <DisplayHintType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet Set-Date
de commande remplace 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 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 Adjust .
Exemples
Exemple 1 : Ajouter trois jours à la date système
Cette commande ajoute trois jours à la date système actuelle. Elle n'affecte pas l'heure. La commande utilise le paramètre Date pour spécifier la date.
L’applet Get-Date
de commande retourne la date actuelle sous forme d’objet DateTime . La méthode AddDays de l’objet DateTime ajoute un nombre de jours spécifié (3
) à l’objet DateTime actuel.
Set-Date -Date (Get-Date).AddDays(3)
Exemple 2 : Définir l’horloge système en arrière 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) dans le format d’heure standard pour les paramètres régionaux.
Le paramètre DisplayHint indique à PowerShell d’afficher uniquement l’heure, mais il n’affecte pas l’objet DateTime retourné Set-Date
.
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 en date et 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 Set-Date
commande.
$T = Get-Date
Set-Date -Date $T
Exemple 4 : Ajouter 90 minutes à l’horloge système
Ces commandes avancent de 90 minutes l'heure système sur l'ordinateur local.
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 Adjust de Set-Date
pour ajuster la date en fonction de la valeur de l’objet TimeSpan dans la $90mins
variable.
$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 de la date et de 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 Adjust pour passer un objet TimeSpan de New-TimeSpan
à Set-Date
.
Type: | TimeSpan |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Vous demande une confirmation avant d’exécuter l’applet de commande.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Date
Modifie la date et l'heure en leur affectant les valeurs spécifiées.
Vous pouvez taper une nouvelle date au format de date courte et une heure au format d'heure standard correspondant aux 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
change l’heure à minuit à la date spécifiée. Si vous spécifiez uniquement une heure, la date n'est pas modifiée.
Type: | DateTime |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DisplayHint
Spécifie les éléments de la date et de l’heure 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.
Elle n’affecte pas l’objet DateTime qui Get-Date
récupère.
Type: | DisplayHintType |
Accepted values: | Date, Time, DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entrées
Vous pouvez diriger une date vers cette applet de commande.
Sorties
Cette applet de commande retourne un objet qui représente la date qu’elle a 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 mises à jour et des événements système qui sont 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 Méthodes DateTime et Méthodes TimeSpan dans le Kit de développement logiciel (SDK) .NET.