Set-Date
Wijzigt de systeemtijd op de computer in een tijd die u opgeeft.
Syntax
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 Date .
Gebruik de parameter Aanpassen om een wijzigingsinterval op te geven.
Voorbeelden
Voorbeeld 1: drie dagen toevoegen 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 object DateTime 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 terug ingesteld op 10 minuten.
Met de parameter Aanpassen kunt u een wijzigingsinterval (min tien minuten) opgeven in de standaardtijdnotatie voor de landinstelling.
De parameter DisplayHint geeft powershell opdracht 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 wordt de systeemdatum en -tijd op de lokale computer gewijzigd 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 Object DateTime door te geven aan $T
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 verlengd.
De eerste opdracht gebruikt de New-TimeSpan
cmdlet om een TimeSpan-object te maken met een interval van 90 minuten en slaat dit op in de $90mins
variabele.
De tweede opdracht gebruikt de parameter Adjust van Set-Date
om 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
Parameters
-Adjust
Hiermee geeft u de waarde op waarvoor deze cmdlet optelt of afgetrokken van de huidige datum en tijd.
u kunt een aanpassing in de standaarddatum- en tijdnotatie voor uw landinstelling typen of de parameter Aanpassen gebruiken om een TimeSpan-object van New-TimeSpan
door te geven aan Set-Date
.
Type: | TimeSpan |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Date
Wijzigt 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 |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DisplayHint
Hiermee geeft u op welke elementen van de datum en tijd worden weergegeven. De acceptabele waarden voor deze parameter zijn:
Date
- geeft alleen de datum weer.Time
- geeft alleen de tijd weer.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 |
Accepted values: | Date, Time, DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Invoerwaarden
U kunt een datum doorsnijden naar deze cmdlet.
Uitvoerwaarden
Deze cmdlet retourneert een object dat de datum vertegenwoordigt die is ingesteld.
Notities
- Gebruik deze cmdlet voorzichtig bij het wijzigen van de datum en tijd op de computer. 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 objecten DateTime en TimeSpan die worden gebruikt met
Set-Date
, zoals AddDays, AddMonths en FromFileTime. Zie DateTime-methoden en TimeSpan-methoden in de .NET SDK voor meer informatie.