Set-Date

  • Referens
Modul:
Microsoft.PowerShell.Utility

Ändrar systemtiden på datorn till en tid som du anger.

Syntax

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

Description

Cmdleten Set-Date ändrar systemets datum och tid på datorn till ett datum och en tid som du anger.

Du kan ange ett nytt datum och/eller tid genom att skriva en sträng eller genom att skicka ett DateTime - eller TimeSpan-objekt till Set-Date. Om du vill ange ett nytt datum eller en ny tid använder du parametern Datum . Om du vill ange ett ändringsintervall använder du parametern Justera .

Exempel

Exempel 1: Lägg till tre dagar till systemdatumet

Det här kommandot lägger till tre dagar till det aktuella systemdatumet. Det påverkar inte tiden. Kommandot använder parametern Datum för att ange datumet.

Cmdleten Get-Date returnerar det aktuella datumet som ett DateTime-objekt . DateTime-objektetsAddDays-metod lägger till ett angivet antal dagar (3) till det aktuella DateTime-objektet.

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

Exempel 2: Ställ in systemklockan 10 minuter tillbaka

I det här exemplet anges den aktuella systemtiden med 10 minuter.

Med parametern Justera kan du ange ett ändringsintervall (minus tio minuter) i standardtidsformatet för nationella inställningar.

Parametern DisplayHint instruerar PowerShell att endast visa tiden, men det påverkar inte DateTime-objektet som Set-Date returneras.

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

Exempel 3: Ange datum och tid till ett variabelvärde

Dessa kommandon ändrar systemets datum och tid på den lokala datorn till det datum och den tid som sparats i variabeln $T. Det första kommandot hämtar datumet och lagrar det i $T.

Det andra kommandot använder parametern Date för att skicka DateTime-objektet $T till cmdletenSet-Date.

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

Exempel 4: Lägg till 90 minuter i systemklockan

Dessa kommandon för fram systemtiden på den lokala datorn med 90 minuter.

Det första kommandot använder cmdleten New-TimeSpan för att skapa ett TimeSpan-objekt med ett intervall på 90 minuter och sparar det i variabeln $90mins .

Det andra kommandot använder parametern Justera för för att justera datumet efter värdet för TimeSpan-objektet i variabeln$90mins.Set-Date

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

Parametrar

-Adjust

Anger det värde som den här cmdleten lägger till eller subtraherar från aktuellt datum och tid. kan ange en justering i standardformatet för datum och tid för ditt språk eller använda parametern Justera för att skicka ett TimeSpan-objekt från New-TimeSpan till Set-Date.

Type:TimeSpan
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Date

Ändrar datum och tid till de angivna värdena. Du kan ange ett nytt datum i kort datumformat och en tid i standardtidsformatet för dina nationella inställningar. Eller så kan du skicka ett DateTime-objekt från Get-Date.

Om du anger ett datum, men inte en tid, Set-Date ändras tiden till midnatt på det angivna datumet. Om du bara anger en tid ändras inte datumet.

Type:DateTime
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DisplayHint

Anger vilka element i datum och tid som visas. De godtagbara värdena för den här parametern är:

  • Date – visar endast datumet.
  • Time - visar bara tiden.
  • DateTime – visar datum och tid.

Den här parametern påverkar endast visningen. Det påverkar inte DateTime-objektet som Get-Date hämtar.

Type:DisplayHintType
Accepted values:Date, Time, DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Indata

DateTime

Du kan skicka ett datum till den här cmdleten.

Utdata

DateTime

Den här cmdleten returnerar ett objekt som representerar det datum då det angavs.

Kommentarer

  • Använd den här cmdleten försiktigt när du ändrar datum och tid på datorn. Ändringen kan hindra datorn från att ta emot systemomfattande händelser och uppdateringar som utlöses av ett datum eller en tid. Använd parametrarna WhatIf och Confirm för att undvika fel.
  • Du kan använda .NET-standardmetoder med DateTime - och TimeSpan-objekten som används med Set-Date, till exempel AddDays, AddMonths och FromFileTime. Mer information finns i DateTime-metoder och TimeSpan-metoder i .NET SDK.