Set-Date
Hiermee wijzigt u de systeemtijd op de computer in een tijd die u opgeeft.
Syntaxis
Date (Standaard)
Set-Date
[-Date] <DateTime>
[-DisplayHint <DisplayHintType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Adjust
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 Date. 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 Als administrator uitvoeren.
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 DateTime object AddDays 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 alleen de tijd weer te geven, maar dit heeft geen invloed op het DateTime--object dat Set-Date retourneert.
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 zijn opgeslagen in de variabele $T. Met de eerste opdracht wordt de datum opgeslagen in $T.
De tweede opdracht gebruikt de parameter Date om het DateTime--object in $T door te geven aan de cmdlet Set-Date.
$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 gebruikt de cmdlet New-TimeSpan om een TimeSpan--object met een interval van 90 minuten te maken en op tegeslagen in de $90mins variabele.
De tweede opdracht gebruikt de parameter Aanpassen van Set-Date om de datum aan te passen op basis van de waarde van het TimeSpan--object in de variabele $90mins.
$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 standaardnotatie voor datum en tijd voor uw landinstelling of de parameter Aanpassen gebruiken om een TimeSpan--object door te geven van New-TimeSpan tot Set-Date.
Parametereigenschappen
| Type: | TimeSpan |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
Adjust
| Position: | 0 |
| Verplicht: | True |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-Confirm
Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Cf |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | 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 de tijd op de opgegeven datum wijzigen in middernacht. Als u alleen een tijd opgeeft, wordt de datum niet gewijzigd.
Parametereigenschappen
| Type: | DateTime |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
Date
| Position: | 0 |
| Verplicht: | True |
| Waarde uit pijplijn: | True |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-DisplayHint
Hiermee geeft u op welke elementen van de datum en tijd worden weergegeven. De acceptabele waarden voor deze parameter zijn:
-
Date- alleen de datum wordt weergegeven. -
Time: alleen de tijd wordt weergegeven. -
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 ophaalt.
Parametereigenschappen
| Type: | DisplayHintType |
| Default value: | None |
| Geaccepteerde waarden: | Date, Time, DateTime |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-WhatIf
Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Wi |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.
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 WhatIf- en parameters bevestigen om fouten te voorkomen.
- U kunt standaard .NET-methoden gebruiken met de DateTime- en TimeSpan-objecten die worden gebruikt met
Set-Date, zoals AddDays, AddMonthsen FromFileTime. Zie DateTime Methods and TimeSpan Methods in de .NET SDK voor meer informatie.