Udostępnij za pośrednictwem

Set-Date

  • Odwołanie
Moduł:
Microsoft.PowerShell.Utility

Zmienia czas systemowy na komputerze na określony czas.

Składnia

Set-Date
   [-Date] <DateTime>
   [-DisplayHint <DisplayHintType>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-Date
   [-Adjust] <TimeSpan>
   [-DisplayHint <DisplayHintType>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Opis

Polecenie Set-Date cmdlet 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 na 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 Get-Date cmdlet 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 zmiany (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-Date DateTime.

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 pliku $T.

Drugie polecenie używa parametru Date do przekazania obiektu DateTime w $T poleceniu Set-Date cmdlet.

$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 New-TimeSpan polecenia cmdlet do utworzenia obiektu TimeSpan z 90-minutowym interwałem i zapisuje go w zmiennej $90mins .

Drugie polecenie używa parametru Dostosuj parametr , Set-Date aby dostosować datę według 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.

Typ:TimeSpan
Position:0
wartość domyślna:None
Wymagane:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliases:cf
Position:Named
wartość domyślna:False
Wymagane:False
Accept pipeline input:False
Accept wildcard characters: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 z pliku Get-Date.

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.

Typ:DateTime
Position:0
wartość domyślna:None
Wymagane:True
Accept pipeline input:True
Accept wildcard characters: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-Date DateTime.

Typ:DisplayHintType
akceptowane wartości:Date, Time, DateTime
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie jest uruchamiane.

Typ:SwitchParameter
Aliases:wi
Position:Named
wartość domyślna:False
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

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 obiektami DateTime i TimeSpan używanymi z elementami Set-Date, takimi jak AddDays, AddMonths i FromFileTime. Aby uzyskać więcej informacji, zobacz Metody dateTime i metody TimeSpan w zestawie .NET SDK.