Dela via

Set-Date

Modul:
Microsoft.PowerShell.Utility Module

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

Syntax

Date (Standard) 

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

Adjust 

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.

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

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

Parameteregenskaper

Typ:TimeSpan
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

Adjust
Position:0
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Confirm

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:jfr

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:DateTime
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

Date
Position:0
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument: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- objekt som Get-Date hämtar.

Parameteregenskaper

Typ:DisplayHintType
Standardvärde:None
Godkända värden:Date, Time, DateTime
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-WhatIf

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:Wi

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

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