Sdílet prostřednictvím

Set-Date

  • Reference
Modul:
Microsoft.PowerShell.Utility

Změní systémový čas v počítači na zadaný čas.

Syntaxe

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

Description

Rutina Set-Date změní systémové datum a čas v počítači na datum a čas, které zadáte. Nové datum nebo čas můžete zadat zadáním řetězce nebo předáním dateTime nebo TimeSpan objektu do Set-Date. Pokud chcete zadat nové datum nebo čas, použijte parametr Date. Pokud chcete zadat interval změn, použijte parametr Adjust.

Příklady

Příklad 1: Přidání tří dnů do systémového data

Tento příkaz přidá k aktuálnímu systémovému datu tři dny. Nemá vliv na čas. Příkaz k zadání data používá parametr Date.

Rutina Get-Date vrátí aktuální datum jako objekt DateTime. Metoda DateTime objektu AddDays přidá zadaný počet dnů (3) k aktuálnímu objektu DateTime.

Set-Date -Date (Get-Date).AddDays(3)

Příklad 2: Nastavení systémových hodin zpět 10 minut

Tento příklad nastaví aktuální systémový čas zpět o 10 minut.

Parametr Adjust umožňuje zadat interval změny (minus deset minut) ve standardním formátu času národního prostředí.

Parametr DisplayHint říká PowerShellu, aby zobrazil pouze čas, ale nemá vliv na objekt DateTime, který Set-Date vrátí.

Set-Date -Adjust -0:10:0 -DisplayHint Time

Příklad 3: Nastavení data a času na hodnotu proměnné

Tyto příkazy změní systémové datum a čas v místním počítači na datum a čas uložený v proměnné $T. První příkaz získá datum a uloží ho do $T.

Druhý příkaz použije parametr Date k předání objektu DateTime v $T rutině Set-Date.

$T = Get-Date
Set-Date -Date $T

Příklad 4: Přidání 90 minut do systémového času

Tyto příkazy posílají systémový čas na místním počítači o 90 minut.

První příkaz pomocí rutiny New-TimeSpan vytvoří objekt TimeSpan s 90minutovým intervalem a uloží ho do proměnné $90mins.

Druhý příkaz používá parametr AdjustSet-Date k úpravě data podle hodnoty objektu TimeSpan v proměnné $90mins.

$90mins = New-TimeSpan -Minutes 90
Set-Date -Adjust $90mins

Parametry

-Adjust

Určuje hodnotu, pro kterou tato rutina sčítá nebo odečte od aktuálního data a času. může zadat úpravu ve standardním formátu data a času pro národní prostředí nebo pomocí parametru Adjust předat objekt TimeSpan z New-TimeSpan do Set-Date.

Typ:TimeSpan
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Date

Změní datum a čas na zadané hodnoty. Nové datum můžete zadat ve formátu krátkého data a času ve standardním formátu času pro národní prostředí. Nebo můžete předat objekt DateTime z Get-Date.

Pokud zadáte datum, ale ne čas, Set-Date změní čas na půlnoc zadaného data. Pokud zadáte jenom čas, nezmění se datum.

Typ:DateTime
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-DisplayHint

Určuje, které prvky data a času se zobrazí. Přijatelné hodnoty pro tento parametr jsou:

  • datum. zobrazí pouze datum.
  • čas. zobrazí pouze čas.
  • DateTime . zobrazí datum a čas.

Tento parametr má vliv pouze na zobrazení. Nemá vliv na objekt DateTime, který Get-Date načte.

Typ:DisplayHintType
Přípustné hodnoty:Date, Time, DateTime
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

DateTime

Datum můžete převést na Set-Date.

Výstupy

DateTime

Set-Date vrátí objekt, který představuje datum, které nastavil.

Poznámky

  • Tuto rutinu používejte obezřetně při změně data a času v počítači. Tato změna může počítači zabránit v přijímání událostí a aktualizací v celém systému, které jsou aktivovány datem nebo časem. Pokud se chcete vyhnout chybám, použijte WhatIf a Potvrdit parametry.

  • Standardní metody .NET můžete použít s DateTime a TimeSpan objekty používané s Set-Date, například AddDays, AddMonthsa FromFileTime. Další informace najdete v tématu metody DateTime a

    metody TimeSpan v knihovně MSDN.