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 Set-TimeZone cmdlet 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.

Uwaga

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 ustawione na en-USwartość .

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.

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

-Id

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-InputObject

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

Type:TimeZoneInfo
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

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

-PassThru

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

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 programu Set-TimeZone:

  • Windows:
    • stz

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