Modifie l'heure système sur l'ordinateur en la remplaçant par l'heure que vous spécifiez.

Syntaxe

Set-Date [-Adjust] <TimeSpan> [-DisplayHint {<Date> | <Time> | <DateTime>}] [-Confirmer] [-WhatIf] [<CommonParameters>]

Set-Date [-Date] <DateTime> [-DisplayHint {<Date> | <Time> | <DateTime>}] [-Confirmer] [-WhatIf] [<CommonParameters>]

Description

L'applet de commande Set-Date modifie la date et l'heure système sur l'ordinateur en les remplaçant par la date et l'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.

Paramètres

-Adjust <TimeSpan>

Ajoute ou soustrait la valeur spécifiée de la date et de l'heure actuelles. Vous pouvez taper une valeur de réglage dans le format de date et d'heure standard de vos paramètres régionaux ou utiliser le paramètre Adjust pour passer un objet TimeSpan de New-TimeSpan vers Set-Date.

Obligatoire ?

true

Position ?

1

Valeur par défaut

Accepter l'entrée de pipeline ?

true (ByPropertyName)

Accepter les caractères génériques ?

false

-Date <DateTime>

Modifie la date et l'heure en les remplaçant par les valeurs spécifiées. Vous pouvez taper une nouvelle date dans le format de date court et une heure dans le format d'heure standard pour vos paramètres régionaux. Vous pouvez également passer un objet Date-Time à partir de Get-Date.

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

Obligatoire ?

true

Position ?

1

Valeur par défaut

Accepter l'entrée de pipeline ?

true (ByValue, ByPropertyName)

Accepter les caractères génériques ?

false

-DisplayHint <DisplayHintType>

Détermine quels éléments de la date et de l'heure qui sont affichés.

Les valeurs valides sont :

-- 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 récupéré par Get-Date.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Confirmer

Vous invite à confirmer l'exécution de la commande.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-WhatIf

Décrit le résultat que vous obtiendriez en exécutant la commande, sans réellement l'exécuter.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.

Entrées et sorties

Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.

Entrées

System.DateTime

Vous pouvez diriger une date vers Set-Date.

Sorties

System.DateTime

Set-Date retourne un objet représentant la date qu'il a définie.

Remarques

Utilisez cette applet de commande prudemment. Modification de la date et l'heure sur l'ordinateur. La modification peut empêcher l'ordinateur de recevoir des événements système et les mises à jour qui sont déclenchées par une date ou une heure. Utilisez les paramètres -WhatIf et -Confirm pour éviter les erreurs.

Vous pouvez utiliser les méthodes .NET standard avec les objets DateTime et TimeSpan utilisés avec Set-Date, par exemple AddDays, AddMonths et FromFileTime. Pour plus d'informations, consultez « Méthodes DateTime » et « Méthodes TimeSpan ».

Exemple 1

C:\PS>Set-Date -Date (Get-Date).AddDays(3)

Description
-----------
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. Elle utilise l'applet de commande Get-Date pour obtenir la date et l'heure actuelles, et applique la méthode .NET AddDays pour les objets DateTime avec une valeur de 3 (jours).






Exemple 2

C:\PS>set-date -adjust -0:10:0 -displayHint time

Description
-----------
Cette commande retarde l'heure système actuelle de 10 minutes. Elle utilise le paramètre Adjust pour spécifier un intervalle de modification et la modification de l'heure (moins dix minutes) dans un format d'heure standard pour les paramètres régionaux. Le paramètre DisplayHint indique à Windows PowerShell d'afficher uniquement l'heure, mais n'affecte pas l'objet DateTime retourné par Set-Date.






Exemple 3

C:\PS>$t = get-date

C:\PS>set-date -date $t

Description
-----------
Ces commandes modifient la date et l'heure système sur l'ordinateur en les remplaçant 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 de $t à l'applet de commande Set-Date.






Exemple 4

C:\PS>$90mins = new-timespan -minutes 90

C:\PS>set-date -adjust $90mins

Description
-----------
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, puis enregistre l'objet TimeSpan dans la variable $90mins. La deuxième commande utilise le paramètre Adjust de Set-Date pour ajuster la date selon la valeur de l'objet TimeSpan dans la variable $90mins.






Voir aussi




Table des matières