Sdílet prostřednictvím

Set-TimeZone

  • Reference
Modul:
Microsoft.PowerShell.Management

Nastaví systémové časové pásmo na zadané časové pásmo.

Syntaxe

Set-TimeZone
   [-Name] <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-TimeZone
   -Id <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-TimeZone
   [-InputObject] <TimeZoneInfo>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Tato rutina je dostupná jenom na platformě Windows.

Rutina Set-TimeZone nastaví systémové časové pásmo na zadané časové pásmo.

Příklady

Příklad 1: Nastavení časového pásma podle ID

Tento příklad nastaví časové pásmo místního počítače na UTC.

Set-TimeZone -Id "UTC"

Id                         : UTC
HasIanaId                  : True
DisplayName                : (UTC) Coordinated Universal Time
StandardName               : Coordinated Universal Time
DaylightName               : Coordinated Universal Time
BaseUtcOffset              : 00:00:00
SupportsDaylightSavingTime : False

Příklad 2: Nastavení časového pásma podle názvu

Tento příklad nastaví časové pásmo místního počítače na UTC.

Set-TimeZone -Name 'Coordinated Universal Time' -PassThru

Jak jsme viděli v předchozím příkladu, ID a název časového pásma se vždy neshodují. Parametr Name se musí shodovat s vlastnostmi StandardName nebo DaylightName objektu TimeZoneInfo .

Poznámka:

Názvy časových pásem se můžou lišit v závislosti na nastavení jazykové verze ve Windows. Tento příklad ukazuje hodnoty pro systém nastavený na en-US.

Příklad 3 – Výpis všech dostupných časových pásem

Úplný seznam ID časových pásem lze získat spuštěním následujícího příkazu:

Get-TimeZone -ListAvailable

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu 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

-Id

Určuje ID časového pásma, které tato rutina nastaví.

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

-InputObject

Určuje objekt TimeZoneInfo , který se má použít jako vstup.

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

-Name

Určuje název časového pásma, které tato rutina nastaví. Úplný seznam názvů časových pásem lze získat spuštěním následujícího příkazu: Get-TimeZone -ListAvailable.

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

-PassThru

Vrátí objekt představující položku, se kterou pracujete. Ve výchozím nastavení tato rutina negeneruje žádný výstup.

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

-WhatIf

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

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

String

TimeZoneInfo

Výstupy

None

Ve výchozím nastavení tato rutina nevrací žádný výstup.

TimeZoneInfo

Pokud použijete parametr PassThru , vrátí tato rutina objekt TimeZoneInfo .

Poznámky

PowerShell obsahuje následující aliasy pro Set-TimeZone:

  • Windows:
    • stz

Tato rutina je dostupná jenom na platformách Windows.