Set-Date

  • Referenz
Modul:
Microsoft.PowerShell.Utility

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

Syntax

Set-Date
   [-Date] <DateTime>
   [-DisplayHint <DisplayHintType>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
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übergeben. Verwenden Sie den Date-Parameter , um ein neues Datum oder eine neue Uhrzeit anzugeben. Verwenden Sie den Parameter Adjust , um ein Änderungsintervall anzugeben.

Beispiele

Beispiel 1: Hinzufügen von drei Tagen zum Systemdatum

Mit diesem Befehl werden dem aktuellen Datum drei Tage hinzugefügt. Er wirkt sich nicht auf die Uhrzeit aus. Der Befehl verwendet den Date-Parameter , 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 wieder 10 Minuten

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

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

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

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

Beispiel 3: Festlegen von Datum und 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 Date-Parameter , 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 stellen die Systemzeit auf dem lokalen Computer um 90 Minuten vor.

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 Adjust von, Set-Date um das Datum um den Wert des TimeSpan-Objekts in der $90mins Variablen anzupassen.

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

Parameter

-Adjust

Gibt den Wert an, für den dieses Cmdlet das aktuelle Datum und die aktuelle Uhrzeit hinzufügt oder subtrahiert. kann eine Anpassung im Standarddatums- und Uhrzeitformat für Ihr Gebietsschema eingeben oder den Parameter Adjust verwenden, um ein TimeSpan-Objekt von New-TimeSpan an zu Set-Dateübergeben.

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

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters: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. Alternativ können Sie ein DateTime-Objekt von Get-Dateübergeben.

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

Type:DateTime
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters: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 Datum und Uhrzeit an.

Dieser Parameter betrifft nur die Anzeige. Dies wirkt sich nicht auf das dateTime-Objekt aus, das Get-Date abgerufen wird.

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

-WhatIf

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

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

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 möglicherweise verhindern, dass der Computer systemweite Ereignisse und Updates erhält, die durch einen Datums- oder Uhrzeitwert ausgelöst werden. Verwenden Sie die Parameter WhatIf und Confirm , um Fehler zu vermeiden.
  • Sie können .NET-Standardmethoden mit den DateTime- und TimeSpan-Objekten verwenden, die mit Set-Dateverwendet werden, z. B . AddDays, AddMonths und FromFileTime. Weitere Informationen finden Sie unter DateTime-Methoden und TimeSpan-Methoden im .NET SDK.