Delen via

Set-Date

  • Referentie
Module:
Microsoft.PowerShell.Utility

Hiermee wijzigt u de systeemtijd op de computer in een tijd die u opgeeft.

Syntaxis

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

Description

De Set-Date cmdlet wijzigt de systeemdatum en -tijd op de computer in een datum en tijd die u opgeeft.

U kunt een nieuwe datum en/of tijd opgeven door een tekenreeks te typen of door een DateTime - of TimeSpan-object door te geven aan Set-Date. Als u een nieuwe datum of tijd wilt opgeven, gebruikt u de parameter Datum . Als u een wijzigingsinterval wilt opgeven, gebruikt u de parameter Aanpassen .

U moet beheerdersrechten hebben om de systeemdatum en -tijd te wijzigen. Start PowerShell in Windows met de optie Uitvoeren als administrator .

Voorbeelden

Voorbeeld 1: Voeg drie dagen toe aan de systeemdatum

Met deze opdracht worden drie dagen toegevoegd aan de huidige systeemdatum. Dit heeft geen invloed op de tijd. De opdracht gebruikt de parameter Date om de datum op te geven.

De Get-Date cmdlet retourneert de huidige datum als een DateTime-object . De methode AddDays van het DateTime-object voegt een opgegeven aantal dagen (3) toe aan het huidige DateTime-object.

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

Voorbeeld 2: De systeemklok 10 minuten terugzetten

In dit voorbeeld wordt de huidige systeemtijd teruggezet op 10 minuten.

Met de parameter Aanpassen kunt u een wijzigingsinterval (min tien minuten) opgeven in de standaardtijdnotatie voor de landinstelling.

De parameter DisplayHint vertelt PowerShell om alleen de tijd weer te geven, maar dit heeft geen invloed op het DateTime-object dat Set-Date wordt geretourneerd.

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

Voorbeeld 3: De datum en tijd instellen op een variabele waarde

Met deze opdrachten wijzigt u de systeemdatum en -tijd op de lokale computer in de datum en tijd die in de variabele $Tzijn opgeslagen. Met de eerste opdracht wordt de datum opgeslagen en opgeslagen in $T.

De tweede opdracht gebruikt de parameter Date om het DateTime-object door $T te geven aan de Set-Date cmdlet.

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

Voorbeeld 4: 90 minuten toevoegen aan de systeemklok

Met deze opdrachten wordt de systeemtijd op de lokale computer met 90 minuten vooruit.

De eerste opdracht maakt gebruik van de cmdlet voor het New-TimeSpan maken van een TimeSpan-object met een interval van 90 minuten en slaat deze op in de $90mins variabele.

De tweede opdracht gebruikt de parameter Aanpassen om Set-Date de datum aan te passen op basis van de waarde van het Object TimeSpan in de $90mins variabele.

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

5: Wijzigen in een specifieke datum en tijd

In het volgende voorbeeld wordt de datum en tijd ingesteld op een specifieke waarde.

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

Parameters

-Adjust

Hiermee geeft u de waarde op waarvoor deze cmdlet wordt toegevoegd of afgetrokken van de huidige datum en tijd. U kunt een aanpassing typen in de standaarddatum- en tijdnotatie voor uw landinstelling of de parameter Aanpassen gebruiken om een TimeSpan-object door te geven van New-TimeSpan naar Set-Date.

Type:TimeSpan
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Date

Hiermee wijzigt u de datum en tijd in de opgegeven waarden. U kunt een nieuwe datum typen in de korte datumnotatie en een tijd in de standaardtijdnotatie voor uw landinstelling. U kunt ook een DateTime-object doorgeven vanuit Get-Date.

Als u een datum opgeeft, maar geen tijd, Set-Date wijzigt u de tijd in middernacht op de opgegeven datum. Als u alleen een tijd opgeeft, wordt de datum niet gewijzigd.

Type:DateTime
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-DisplayHint

Hiermee geeft u op welke elementen van de datum en tijd worden weergegeven. De aanvaardbare waarden voor deze parameter zijn:

  • Date - geeft alleen de datum weer.
  • Time - alleen de tijd weergeven.
  • DateTime - geeft de datum en tijd weer.

Deze parameter is alleen van invloed op de weergave. Dit heeft geen invloed op het DateTime-object dat Get-Date wordt opgehaald.

Type:DisplayHintType
Geaccepteerde waarden:Date, Time, DateTime
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

DateTime

U kunt een datum naar deze cmdlet doorsluisen.

Uitvoerwaarden

DateTime

Met deze cmdlet wordt een object geretourneerd dat de datum aangeeft waarop deze is ingesteld.

Notities

  • Gebruik deze cmdlet voorzichtig wanneer u de datum en tijd op de computer wijzigt. De wijziging voorkomt mogelijk dat de computer systeembrede gebeurtenissen en updates ontvangt die worden geactiveerd door een datum of tijd. Gebruik de parameters WhatIf en Confirm om fouten te voorkomen.
  • U kunt standaard .NET-methoden gebruiken met de DateTime - en TimeSpan-objecten die worden gebruikt met Set-Date, zoals AddDays, AddMonths en FromFileTime. Zie DateTime-methoden en TimeSpan-methoden in de .NET SDK voor meer informatie.