Dela via

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 Date. 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 Date för att ange datumet.

Cmdleten Get-Date returnerar det aktuella datumet som ett DateTime--objekt. Metoden DateTime-objektets AddDays 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 språkvarianten.

Parametern DisplayHint anger att PowerShell endast ska visa tiden, men det påverkar inte DateTime- objekt som Set-Date returnerar.

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 i $T till cmdleten Set-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 Set-Date för att justera datumet efter värdet för objektet TimeSpan i variabeln $90mins.

$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.

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. Du kan också skicka ett DateTime--objekt från Get-Date.

Om du anger ett datum, men inte en tid, ändrar Set-Date 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 godtagbara värdena för den här parametern är:

  • Datum – 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- objekt 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örs. 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 Set-Date.

Utdata

DateTime

Set-Date 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-objekt som används med Set-Date, till exempel AddDays, AddMonthsoch FromFileTime. Mer information finns i DateTime-metoder och

    TimeSpan-metoder i .NET SDK.