Freigeben über

Set-TimeZone

  • Referenz
Modul:
Microsoft.PowerShell.Management

Legt die Systemzeitzone auf eine angegebene Zeitzone fest.

Syntax

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

Beschreibung

Dieses Cmdlet ist nur auf der Windows-Plattform verfügbar.

Das Set-TimeZone Cmdlet legt die Systemzeitzone auf eine angegebene Zeitzone fest.

Beispiele

Beispiel 1: Festlegen der Zeitzone nach ID

In diesem Beispiel wird die Zeitzone auf dem lokalen Computer auf UTC festgelegt.

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

Beispiel 2: Festlegen der Zeitzone anhand des Namens

In diesem Beispiel wird die Zeitzone auf dem lokalen Computer auf UTC festgelegt.

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

Wie wir im vorherigen Beispiel gesehen haben, stimmen die ID und der Name der Zeitzone nicht immer überein. Der Name-Parameter muss mit den Eigenschaften "StandardName" oder "DaylightName" des TimeZoneInfo-Objekts übereinstimmen.

Hinweis

Die Zeitzonennamen können je nach den Kultureinstellungen in Windows variieren. Dieses Beispiel zeigt die Werte für ein System, das auf en-US.

Beispiel 3 : Alle verfügbaren Zeitzonen auflisten

Eine vollständige Liste der Zeitzonen-IDs kann durch Ausführen des folgenden Befehls abgerufen werden:

Get-TimeZone -ListAvailable

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Id

Gibt die ID der Zeitzone an, die dieses Cmdlet festlegt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-InputObject

Gibt ein TimeZoneInfo -Objekt an, das als Eingabe verwendet werden soll.

Typ:TimeZoneInfo
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen der Zeitzone an, die dieses Cmdlet festlegt. Eine vollständige Liste der Namen der Zeitzone kann durch Ausführen des folgenden Befehls abgerufen werden: Get-TimeZone -ListAvailable

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PassThru

Gibt ein Objekt zurück, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

String

TimeZoneInfo

Ausgaben

None

Standardmäßig gibt dieses Cmdlet keine Ausgabe zurück.

TimeZoneInfo

Wenn Sie den PassThru-Parameter verwenden, gibt dieses Cmdlet ein TimeZoneInfo-Objekt zurück.

Hinweise

PowerShell enthält die folgenden Aliase für Set-TimeZone:

  • Windows:
    • stz

Dieses Cmdlet ist nur auf Windows-Plattformen verfügbar.