Sdílet prostřednictvím

Set-Date

Modul:
Microsoft.PowerShell.Utility Module

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

Syntax

Date (Výchozí) 

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

Adjust 

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.

Vlastnosti parametru

Typ:TimeSpan
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

Adjust
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-Confirm

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

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False
Aliasy:viz

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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.

Vlastnosti parametru

Typ:DateTime
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

Date
Position:0
Povinné:True
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů: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.

Vlastnosti parametru

Typ:DisplayHintType
Default value:None
Přípustné hodnoty:Date, Time, DateTime
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-WhatIf

Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False
Aliasy:Wi

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

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.