Set-Date
Ä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 Uhrzeit auf dem Computer in ein Datum und eine Uhrzeit, die Sie angeben.
Sie können ein neues Datum und/oder eine Uhrzeit angeben, indem Sie eine Zeichenfolge eingeben oder ein DateTime- oder TimeSpan-Objekt übergeben.Set-Date
Um ein neues Datum oder eine neue Uhrzeit anzugeben, verwenden Sie den Datumsparameter .
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 Datum drei Tage hinzugefügt. Er wirkt sich nicht auf die Uhrzeit aus. Der Befehl verwendet den Datumsparameter, 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 zurück 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 teilt PowerShell mit, 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 Uhrzeit auf dem lokalen Computer in das Datum und die Uhrzeit, die in der Variablen $T
gespeichert 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 es in der $90mins
Variablen zu speichern.
Der zweite Befehl verwendet den Parameter Set-Date
"Anpassen", um das Datum nach dem Wert des TimeSpan-Objekts in der $90mins
Variable 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 "Anpassen " verwenden, um ein TimeSpan-Objekt von zu New-TimeSpan
Set-Date
übergeben.
Type: | TimeSpan |
Position: | 0 |
Default value: | None |
Required: | True |
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 |
Required: | 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. Oder Sie können ein DateTime-Objekt von Get-Date
.
Wenn Sie ein Datum angeben, aber keine Uhrzeit, Set-Date
ändert die Uhrzeit auf Mitternacht am angegebenen Datum. Wenn Sie nur eine Uhrzeit angeben, wird das Datum nicht geändert.
Type: | DateTime |
Position: | 0 |
Default value: | None |
Required: | True |
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:
- Datum – zeigt nur das Datum an.
- Uhrzeit – zeigt nur die Uhrzeit an.
- DateTime – zeigt das Datum und die Uhrzeit an.
Dieser Parameter betrifft nur die Anzeige.
Es 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 |
Required: | False |
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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Eingaben
Sie können ein Datum an Set-Date
.
Ausgaben
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 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 " Bestätigen ", um Fehler zu vermeiden.
Sie können standardmäßige .NET-Methoden mit den mit AddDays, AddMonths und FromFileTime verwendeten
Set-Date
DateTime- und TimeSpan-Objekten verwenden. Weitere Informationen finden Sie unter DateTime-Methoden undTimeSpan-Methoden im .NET SDK.