Set-Date

  • Reference
Modul:
Microsoft.PowerShell.Utility

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

Syntax

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 objektu DateTime nebo TimeSpan objektu 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 AddDays objektu DateTime 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 pro národní prostředí.

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

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

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

Tyto příkazy mě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žívá parametr Date k předání objektu $TDateTime do rutinySet-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 $90mins do proměnné.

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

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

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

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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í se čas na půlnoc zadaného data. Pokud zadáte jenom čas, nezmění se datum.

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

-DisplayHint

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

  • Date - zobrazí pouze datum.
  • Time - zobrazí pouze čas.
  • DateTime - zobrazí datum a čas.

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

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Vstupy

DateTime

K této rutině můžete připojit datum.

Výstupy

DateTime

Tato rutina vrátí objekt, který představuje datum, kdy byla nastavena.

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. K zabránění chybám použijte parametry WhatIf a Confirm.
  • Standardní metody .NET můžete použít s objekty DateTime a TimeSpan používané s Set-Dateobjekty , jako jsou AddDays, AddMonths a FromFileTime. Další informace naleznete v tématu Metody DateTime a Metody TimeSpan v sadě .NET SDK.