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 .

Du måste ha administratörsbehörighet för att ändra systemets datum och tid. I Windows startar du PowerShell med alternativet Kör som administratör .

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-objektets AddDays-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

5: Ändra till ett visst datum och en viss tid

I följande exempel anges datum och tid till ett specifikt värde.

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

Parametrar

-Adjust

Anger det värde som den här cmdleten lägger till eller subtraherar från aktuellt datum och tid. Du kan ange en justering i standardformat 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.

Typ:TimeSpan
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Confirm

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

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:DateTime
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-DisplayHint

Anger vilka element i datum och tid som visas. De acceptabla 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.

Typ:DisplayHintType
Godkända värden:Date, Time, DateTime
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

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

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.