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.