Set-Date

Modul:
Microsoft.PowerShell.Utility Module

Ändert die Systemzeit auf dem Computer in eine von Ihnen angegebene Uhrzeit.

Syntax

Date (Standard) 

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

Adjust 

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

Beschreibung

Das Set-Date Cmdlet ändert das Systemdatum und die Systemzeit auf dem Computer in ein von Ihnen angegebenes Datum und eine Uhrzeit.

Sie können ein neues Datum und/oder eine neue Uhrzeit angeben, indem Sie eine Zeichenfolge eingeben oder ein DateTime - oder TimeSpan-Objekt an Set-Date. Verwenden Sie den Date-Parameter , um ein neues Datum oder eine neue Uhrzeit anzugeben. Verwenden Sie den Parameter "Anpassen ", um ein Änderungsintervall anzugeben.

Sie müssen über Administratorrechte verfügen, um das Systemdatum und die Systemzeit zu ändern. Starten Sie auf Windows PowerShell mit der Option Run as administrator.

Beispiele

Beispiel 1: Hinzufügen von drei Tagen zum Systemdatum

Mit diesem Befehl werden dem aktuellen Systemdatum drei Tage hinzugefügt. Dies wirkt sich nicht auf die Zeit aus. Der Befehl verwendet den Parameter Date , um das Datum anzugeben.

Das Get-Date Cmdlet gibt das aktuelle Datum als DateTime-Objekt zurück. Die AddDays-Methode des DateTime-Objekts fügt dem aktuellen DateTime-Objekt eine angegebene Anzahl von Tagen (3) hinzu.

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

Beispiel 2: Festlegen der Systemuhr auf 10 Minuten

In diesem Beispiel wird die aktuelle Systemzeit um 10 Minuten zurückgesetzt.

Mit dem Parameter "Adjust " können Sie ein Änderungsintervall (minus zehn Minuten) im Standardzeitformat für das Gebietsschema angeben.

Der Parameter DisplayHint weist PowerShell an, nur die Uhrzeit anzuzeigen, wirkt sich jedoch nicht auf das dateTime-Objekt aus, das Set-Date zurückgegeben wird.

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

Beispiel 3: Festlegen des Datums und der Uhrzeit auf einen Variablenwert

Diese Befehle ändern das Systemdatum und die Systemzeit auf dem lokalen Computer in das Datum und die Uhrzeit, die in der Variablen $Tgespeichert sind. Der erste Befehl ruft das Datum ab und speichert es in $T.

Der zweite Befehl verwendet den Parameter Date , um das DateTime-Objekt an $T das Set-Date Cmdlet zu übergeben.

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

Beispiel 4: Hinzufügen von 90 Minuten zur Systemuhr

Diese Befehle führen die Systemzeit auf dem lokalen Computer um 90 Minuten weiter.

Der erste Befehl verwendet das New-TimeSpan Cmdlet, um ein TimeSpan-Objekt mit einem 90-Minuten-Intervall zu erstellen und in der $90mins Variablen zu speichern.

Der zweite Befehl verwendet den Parameter Set-Date"Anpassen", um das Datum anhand des Werts des TimeSpan-Objekts in der $90mins Variablen anzupassen.

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

5: Ändern in ein bestimmtes Datum und eine bestimmte Uhrzeit

Im folgenden Beispiel wird das Datum und die Uhrzeit auf einen bestimmten Wert festgelegt.

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

Parameter

-Adjust

Gibt den Wert an, für den dieses Cmdlet das aktuelle Datum und die aktuelle Uhrzeit addiert oder subtrahiert. Sie können eine Anpassung im Standarddatums- und Uhrzeitformat für Ihr Gebietsschema eingeben oder den Parameter "Anpassen" verwenden, um ein TimeSpan-Objekt von New-TimeSpan an zu Set-Dateübergeben.

Parametereigenschaften

Typ:TimeSpan
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Adjust
Position:0
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Cf

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Date

Ändert das Datum und die Uhrzeit in die angegebenen Werte. Sie können ein neues Datum im kurzen Datumsformat und eine Uhrzeit im Standardzeitformat für Ihr Gebietsschema eingeben. Oder Sie können ein DateTime-Objekt von Get-Date.

Wenn Sie ein Datum angeben, aber keine Uhrzeit, Set-Date ändert die Uhrzeit an Mitternacht am angegebenen Datum. Wenn Sie nur eine Uhrzeit angeben, wird das Datum nicht geändert.

Parametereigenschaften

Typ:DateTime
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Date
Position:0
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-DisplayHint

Gibt an, welche Elemente des Datums und der Uhrzeit angezeigt werden. Die zulässigen Werte für diesen Parameter sind:

  • Date - zeigt nur das Datum an.
  • Time - zeigt nur die Uhrzeit an.
  • DateTime - zeigt das Datum und die Uhrzeit an.

Dieser Parameter wirkt sich nur auf die Anzeige aus. Es wirkt sich nicht auf das DateTime-Objekt aus, das Get-Date abgerufen wird.

Parametereigenschaften

Typ:DisplayHintType
Standardwert:None
Zulässige Werte:Date, Time, DateTime
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

DateTime

Sie können ein Datum an dieses Cmdlet weiterleiten.

Ausgaben

DateTime

Dieses Cmdlet gibt ein Objekt zurück, das das festgelegte Datum darstellt.

Hinweise

  • Verwenden Sie dieses Cmdlet vorsichtig, wenn Sie das Datum und die Uhrzeit auf dem Computer ändern. Die Änderung kann verhindern, dass der Computer systemweite Ereignisse und Updates empfängt, die durch ein Datum oder eine Uhrzeit ausgelöst werden. Verwenden Sie die Parameter WhatIf und Confirm , um Fehler zu vermeiden.
  • Sie können Standardmethoden .NET mit den Objekten DateTime und TimeSpan verwenden, die mit Set-Date verwendet werden, wie AddDays, AddMonths und FromFileTime. Weitere Informationen finden Sie unter DateTime-Methoden und TimeSpan-Methoden im .NET SDK.