Set-TimeZone

Legt die Systemzeitzone auf eine angegebene Zeitzone fest.

Syntax

Name (Standard)

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

Id

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

InputObject

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.

Note

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

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Cf

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Id

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Id
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-InputObject

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

Parametereigenschaften

Typ:TimeZoneInfo
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

InputObject
Position:0
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Name
Position:0
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PassThru

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WhatIf

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

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:

  • Fenster:
    • stz

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