Set-Date
Zmienia czas systemowy na komputerze na określony czas.
Składnia
Date (Domyślna)
Set-Date
[-Date] <DateTime>
[-DisplayHint <DisplayHintType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Adjust
Set-Date
[-Adjust] <TimeSpan>
[-DisplayHint <DisplayHintType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Opis
Polecenie cmdlet Set-Date zmienia datę i godzinę systemową na komputerze na datę i godzinę, którą określisz.
Możesz określić nową datę i/lub godzinę, wpisując ciąg lub przekazując obiekt DateTime lub TimeSpan, aby Set-Date. Aby określić nową datę lub godzinę, użyj parametru Date. Aby określić interwał zmiany, użyj parametru Dostosuj.
Aby zmienić datę i godzinę systemu, musisz mieć uprawnienia administracyjne. W systemie Windows uruchom program PowerShell z opcją Uruchom jako administrator .
Przykłady
Przykład 1: Dodawanie trzech dni do daty systemowej
To polecenie dodaje trzy dni do bieżącej daty systemu. Nie ma to wpływu na czas. Polecenie używa parametru Date, aby określić datę.
Polecenie cmdlet Get-Date zwraca bieżącą datę jako obiekt DateTime. Metoda AddDays obiektu DateTime dodaje określoną liczbę dni (3) do bieżącego obiektu DateTime.
Set-Date -Date (Get-Date).AddDays(3)
Przykład 2: Ustawianie zegara systemowego z powrotem 10 minut
W tym przykładzie ustawia bieżący czas systemowy z powrotem o 10 minut.
Parametr Dostosuj umożliwia określenie interwału zmian (minus dziesięć minut) w formacie czasu standardowego dla ustawień regionalnych.
Parametr DisplayHint informuje program PowerShell o wyświetlaniu tylko czasu, ale nie ma wpływu na zwracany obiekt Set-DateDateTime.
Set-Date -Adjust -0:10:0 -DisplayHint Time
Przykład 3. Ustawianie daty i godziny na wartość zmiennej
Te polecenia zmieniają datę i godzinę systemową na komputerze lokalnym na datę i godzinę zapisaną w zmiennej $T. Pierwsze polecenie pobiera datę i zapisuje ją w $T.
Drugie polecenie używa parametru Date do przekazania obiektu DateTime w $T do polecenia cmdlet Set-Date.
$T = Get-Date
Set-Date -Date $T
Przykład 4: Dodawanie 90 minut do zegara systemowego
Te polecenia przesuwają czas systemowy na komputerze lokalnym o 90 minut.
Pierwsze polecenie używa polecenia cmdlet
Drugie polecenie używa parametru DostosujSet-Date, aby dostosować datę do wartości obiektu TimeSpan w zmiennej $90mins.
$90mins = New-TimeSpan -Minutes 90
Set-Date -Adjust $90mins
5: Zmiana na określoną datę i godzinę
Poniższy przykład ustawia datę i godzinę na określoną wartość.
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
Parametry
-Adjust
Określa wartość, dla której to polecenie cmdlet dodaje lub odejmuje od bieżącej daty i godziny. Możesz wpisać korektę w standardowym formacie daty i godziny dla ustawień regionalnych lub użyć parametru Dostosuj , aby przekazać obiekt TimeSpan z New-TimeSpan do Set-Date.
Właściwości parametru
| Typ: | TimeSpan |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
Adjust
| Position: | 0 |
| Obowiązkowy: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-Confirm
Prosi o potwierdzenie przed uruchomieniem cmdletu.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | por |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Date
Zmienia datę i godzinę na określone wartości. Możesz wpisać nową datę w formacie daty krótkiej i godzinę w formacie czasu standardowego dla ustawień regionalnych. Możesz też przekazać obiekt datetime
Jeśli określisz datę, ale nie godzinę, Set-Date zmieni godzinę na północ w określonej dacie. Jeśli określisz tylko godzinę, nie zmieni daty.
Właściwości parametru
| Typ: | DateTime |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
Date
| Position: | 0 |
| Obowiązkowy: | True |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-DisplayHint
Określa, które elementy daty i godziny są wyświetlane. Dopuszczalne wartości tego parametru to:
-
Date— wyświetla tylko datę. -
Time— wyświetla tylko czas. -
DateTime— wyświetla datę i godzinę.
Ten parametr ma wpływ tylko na wyświetlanie. Nie ma to wpływu na pobierany obiekt Get-DateDateTime.
Właściwości parametru
| Typ: | DisplayHintType |
| Domyślna wartość: | None |
| Dopuszczalne wartości: | Date, Time, DateTime |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-WhatIf
Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie został uruchomiony.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | Wi |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
Dane wejściowe
DateTime
Możesz przekazać datę do tego polecenia cmdlet.
Dane wyjściowe
DateTime
To polecenie cmdlet zwraca obiekt reprezentujący ustawioną datę.
Uwagi
- Użyj tego polecenia cmdlet ostrożnie podczas zmieniania daty i godziny na komputerze. Zmiana może uniemożliwić komputerowi odbieranie zdarzeń i aktualizacji dotyczących całego systemu, które są wyzwalane przez datę lub godzinę. Użyj parametrów WhatIf i Confirm , aby uniknąć błędów.
- Można użyć standardowych metod .NET z DateTime i TimeSpan obiektów używanych z
Set-Date, takich jak AddDays, AddMonthsi FromFileTime. Aby uzyskać więcej informacji, zobacz Metody dateTime i metody TimeSpan w zestawie .NET SDK.
