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

Syntax

Set-Date [-Adjust] <TimeSpan> [-DisplayHint {<Date> | <Time> | <DateTime>}] [-Bestätigung] [-WhatIf] [<CommonParameters>]

Set-Date [-Datum] <DateTime> [-DisplayHint {<Date> | <Time> | <DateTime>}] [-Bestätigung] [-WhatIf] [<CommonParameters>]

Beschreibung

Mit dem Cmdlet "Set-Date" werden Systemdatum und Systemzeit auf dem Computer in ein Datum und eine Uhrzeit geändert, die von Ihnen angegeben werden. Sie können ein neues Datum und/oder eine neue Uhrzeit angeben, indem Sie eine Zeichenfolge eingeben oder indem Sie ein DateTime-Objekt oder TimeSpan-Objekt an Set-Date übergeben. Um ein neues Datum oder eine neue Uhrzeit anzugeben, verwenden Sie den Date-Parameter. Um ein Änderungsintervall anzugeben, verwenden Sie den Adjust-Parameter.

Parameter

-Adjust <TimeSpan>

Subtrahiert den angegebenen Wert vom aktuellen Datum und der aktuellen Uhrzeit oder fügt ihn diesen hinzu. Sie können einen Anpassungswert im Standarddatums- und -uhrzeitformat für Ihr Gebietsschema eingeben oder mit dem Adjust-Parameter ein TimeSpan-Objekt aus New-TimeSpan an Set-Date übergeben.

Erforderlich?

true

Position?

1

Standardwert

Pipelineeingaben akzeptieren?

true (ByPropertyName)

Platzhalterzeichen akzeptieren?

false

-Datum <DateTime>

Ändert Datum und Uhrzeit in die angegebenen Werte. Sie können ein neues Datum im kurzen Datumsformat und eine Uhrzeit im Standarduhrzeitformat für Ihr Gebietsschema eingeben. Sie können stattdessen auch ein Date-Time-Objekt aus Get-Date übergeben.

Wenn Sie ein Datum, jedoch keine Uhrzeit angeben, ändert Set-Date die Uhrzeit in Mitternacht des angegebenen Datums. Wenn Sie nur eine Uhrzeit angeben, wird das Datum nicht geändert.

Erforderlich?

true

Position?

1

Standardwert

Pipelineeingaben akzeptieren?

true (ByValue, ByPropertyName)

Platzhalterzeichen akzeptieren?

false

-DisplayHint <DisplayHintType>

Bestimmt, welche Elemente von Datum und Uhrzeit angezeigt werden.

Gültige Werte:

– date: Zeigt nur das Datum an.

– time: Zeigt nur die Uhrzeit an.

– datetime: Zeigt Datum und Uhrzeit an.

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

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-Bestätigung

Fordert Sie vor der Ausführung des Befehls zur Bestätigung auf.

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-WhatIf

Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

<CommonParameters>

Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.

Eingaben und Ausgaben

Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.

Eingaben

System.DateTime

Sie können ein Datum über die Pipeline an Set-Date übergeben.

Ausgaben

System.DateTime

Set-Date gibt ein Objekt zurück, das das von ihm erstellte Datum darstellt.

Hinweise

Verwenden Sie dieses Cmdlet mit Bedacht, da Sie damit Datum und Uhrzeit auf dem Computer ändern. Die Änderung verhindert möglicherweise, dass der Computer systemweite Ereignisse und Aktualisierungen empfängt, die durch ein Datum oder eine Uhrzeit ausgelöst werden. Verwenden Sie den -WhatIf-Parameter und den -Confirm-Parameter, um Fehler zu vermeiden.

Sie können für die mit Set-Date verwendeten DateTime-Objekte und TimeSpan-Objekte, z. B. "AddDays", "AddMonths" und "FromFileTime", .NET-Standardmethoden verwenden. Weitere Informationen finden Sie unter "DateTime Methods" und "TimeSpan Methods."

Beispiel 1

C:\PS>Set-Date -Date (Get-Date).AddDays(3)

Beschreibung
-----------
Mit diesem Befehl werden dem aktuellen Systemdatum drei Tage hinzugefügt. Dies wirkt sich nicht auf die Uhrzeit aus. In dem Befehl wird das Datum mit dem Date-Parameter angegeben. Mit dem Cmdlet "Get-Date" werden das aktuelle Datum und die aktuelle Uhrzeit abgerufen, und auf DateTime-Objekte wird die AddDays-.NET-Methode mit dem Wert 3 (Tage) angewendet.






Beispiel 2

C:\PS>set-date -adjust -0:10:0 -displayHint time

Beschreibung
-----------
Mit diesem Befehl wird die aktuelle Systemzeit um 10 Minuten zurückgestellt. Mit dem Adjust-Parameter werden ein Änderungsintervall und die Änderung der Uhrzeit (minus zehn Minuten) im Standarduhrzeitformat für das Gebietsschema angegeben. Der DisplayHint-Parameter legt fest, dass Windows PowerShell nur die Uhrzeit anzeigt, er wirkt sich jedoch nicht auf das von Set-Date zurückgegebene DateTime-Objekt aus.






Beispiel 3

C:\PS>$t = get-date

C:\PS>set-date -date $t

Beschreibung
-----------
Mit diesen Befehlen werden Systemdatum und Systemzeit auf dem Computer in das Datum und die Uhrzeit geändert, die in der Variablen "$t" gespeichert sind. Im ersten Befehl wird das Datum abgerufen und in "$t" gespeichert. Im zweiten Befehl wird das DateTime-Objekt in $t mithilfe des Date-Parameters an das Cmdlet "Set-Date" übergeben.






Beispiel 4

C:\PS>$90mins = new-timespan -minutes 90

C:\PS>set-date -adjust $90mins

Beschreibung
-----------
Mit diesen Befehlen wird die Systemzeit auf dem lokalen Computer um 90 Minuten vorgestellt. Im ersten Befehl wird mit dem Cmdlet "New-Timespan" ein TimeSpan-Objekt mit einem Intervall von 90 Minuten erstellt, und anschließend wird das TimeSpan-Objekt in der Variablen "$90mins" gespeichert. Im zweiten Befehl wird das Datum mit dem Adjust-Parameter von Set-Date entsprechend dem Wert des TimeSpan-Objekts in der Variablen "$90mins" angepasst.






Siehe auch




Inhaltsverzeichnis