Set-Date
Ä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 Cmdlet Set-Date ä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. Um ein neues Datum oder eine neue Uhrzeit anzugeben, verwenden Sie den Parameter Date.
Um ein Änderungsintervall anzugeben, verwenden Sie den Parameter Anpassen.
Beispiele
Beispiel 1: Hinzufügen von drei Tagen zum Systemdatum
Mit diesem Befehl werden dem aktuellen Systemdatum drei Tage hinzugefügt. Sie wirkt sich nicht auf die Zeit aus. Der Befehl verwendet den parameter Date, um das Datum anzugeben.
Das Cmdlet Get-Date 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 "Anpassen" 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 DateTime--Objekt aus, das Set-Date zurückgibt.
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, das in der Variablen $Tgespeichert ist. Der erste Befehl ruft das Datum ab und speichert es in $T.
Der zweite Befehl verwendet den parameter Date, um das DateTime--Objekt in $T an das Cmdlet Set-Date 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 cmdlet New-TimeSpan zum Erstellen eines TimeSpan- Objekts mit einem 90-Minuten-Intervall und speichert es in der $90mins Variablen.
Der zweite Befehl verwendet den Parameter Anpassen von Set-Date, um das Datum anhand des Werts des TimeSpan-Objekts in der variablen $90mins 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 addiert 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 Set-Datezu ü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: | vgl |
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. Alternativ können Sie ein DateTime--Objekt von Get-Dateübergeben.
Wenn Sie ein Datum, aber keine Uhrzeit angeben, ändert Set-Date die Uhrzeit am angegebenen Datum in Mitternacht. 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:
- Datum. zeigt nur das Datum an.
- Uhrzeit. 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 abgerufen Get-Date.
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 Set-Datepfeifen.
Ausgaben
DateTime
Set-Date 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 WhatIf und Parameter bestätigen, um Fehler zu vermeiden.
Sie können .NET-Standardmethoden mit den DateTime- und TimeSpan- Objekten verwenden, die mit
Set-Dateverwendet werden, z. B. AddDays, AddMonthsund FromFileTime. Weitere Informationen finden Sie unter DateTime-Methoden undTimeSpan-Methoden in der MSDN Library.