Udostępnij za pośrednictwem

Set-TimeZone

  • Odwołanie
Moduł:
Microsoft.PowerShell.Management

Ustawia systemową strefę czasową na określoną strefę czasową.

Składnia

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

Opis

To polecenie cmdlet jest dostępne tylko na platformie Windows.

Polecenie cmdlet Set-TimeZone ustawia systemową strefę czasową na określoną strefę czasową.

Przykłady

Przykład 1. Ustawianie strefy czasowej według identyfikatora

W tym przykładzie ustawiono strefę czasową na komputerze lokalnym na czas 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

Przykład 2. Ustawianie strefy czasowej według nazwy

W tym przykładzie ustawiono strefę czasową na komputerze lokalnym na czas UTC.

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

Jak pokazano w poprzednim przykładzie, identyfikator i nazwa strefy czasowej nie zawsze są zgodne. Parametr Name musi być zgodny z właściwościami StandardName lub DaylightName obiektu timeZoneInfo.

Nuta

Nazwy stref czasowych mogą się różnić w zależności od ustawień kultury w systemie Windows. W tym przykładzie przedstawiono wartości dla systemu ustawionego na en-US.

Przykład 3 — wyświetlanie listy wszystkich dostępnych stref czasowych

Pełną listę identyfikatorów stref czasowych można uzyskać, uruchamiając następujące polecenie:

Get-TimeZone -ListAvailable

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Id

Określa identyfikator strefy czasowej ustawianej przez to polecenie cmdlet.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-InputObject

Określa obiekt TimeZoneInfo, który ma być używany jako dane wejściowe.

Typ:TimeZoneInfo
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Name

Określa nazwę strefy czasowej ustawianej przez to polecenie cmdlet. Pełną listę nazw stref czasowych można uzyskać, uruchamiając następujące polecenie: Get-TimeZone -ListAvailable.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PassThru

Zwraca obiekt reprezentujący element, z którym pracujesz. Domyślnie to polecenie cmdlet nie generuje żadnych danych wyjściowych.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String

TimeZoneInfo

Dane wyjściowe

None

Domyślnie to polecenie cmdlet nie zwraca żadnych danych wyjściowych.

TimeZoneInfo

Jeśli używasz parametru PassThru, to polecenie cmdlet zwraca obiekt TimeZoneInfo.

Uwagi

Program PowerShell zawiera następujące aliasy dla Set-TimeZone:

  • Windows:
    • stz

To polecenie cmdlet jest dostępne tylko na platformach windows.