Set-TimeZone
Задает системный часовой пояс для указанного часового пояса.
Синтаксис
Name (по умолчанию)
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>]
Описание
Этот командлет доступен только на платформе Windows.
Командлет Set-TimeZone устанавливает системный часовой пояс на указанный часовой пояс.
Примеры
Пример 1. Установка часового пояса по идентификатору
В этом примере часовой пояс на локальном компьютере устанавливается в формате 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
Пример 2. Установка часового пояса по имени
В этом примере часовой пояс на локальном компьютере устанавливается в формате UTC.
Set-TimeZone -Name 'Coordinated Universal Time' -PassThru
Как мы видели в предыдущем примере, идентификатор и имя часового пояса не всегда совпадают. Параметр Name должен соответствовать свойствам StandardName или DaylightName объекта TimeZoneInfo.
Замечание
Имена часовых поясов могут отличаться в зависимости от настроек культуры в Windows. В этом примере показаны значения для системы, настроенной на en-US.
Пример 3. Вывод списка всех доступных часовых поясов
Полный список идентификаторов часовых поясов можно получить, выполнив следующую команду:
Get-TimeZone -ListAvailable
Параметры
-Confirm
Запрашивает подтверждение перед запуском cmdlet.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Id
Указывает идентификатор часового пояса, который задает этот командлет.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Id
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-InputObject
Указывает объект TimeZoneInfo, используемый в качестве входных данных.
Свойства параметра
| Тип: | TimeZoneInfo |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
InputObject
| Position: | 0 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Name
Указывает имя часового пояса, который задает этот командлет. Полный список имен часовых поясов можно получить, выполнив следующую команду: Get-TimeZone -ListAvailable.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Name
| Position: | 0 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-PassThru
Возвращает объект, представляющий элемент, с которым вы работаете. По умолчанию этот командлет не создает выходные данные.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Показывает, что произойдет, если командлет будет запущен. Командлет не запускается.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
Входные данные
String
TimeZoneInfo
Выходные данные
None
По умолчанию этот командлет не возвращает выходные данные.
TimeZoneInfo
При использовании параметра PassThru этот командлет возвращает объект TimeZoneInfo.
Примечания
PowerShell включает следующие псевдонимы для Set-TimeZone:
- Виндоус:
stz
Этот командлет доступен только на платформах Windows.