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 .

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

Parametry

-Adjust

Określa wartość, dla której to polecenie cmdlet dodaje lub odejmuje od bieżącej daty i godziny. może 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.

Type:TimeSpan
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required: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.

Type:DateTime
Position:0
Default value:None
Required: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 obiekt DateTime , który Get-Date pobiera.

Type:DisplayHintType
Accepted values:Date, Time, DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required: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.