Set-TimeZone (Microsoft.PowerShell.Management)

Set-TimeZone

Модуль:: Microsoft.PowerShell.Management

Устанавливает часовой пояс системы в указанный часовой пояс.

Синтаксис

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

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

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

Запрашивает подтверждение перед запуском командлета.

Тип :: SwitchParameter
Псевдонимы:: cf
Позиция:: Именованный
Значение по умолчанию:: False
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

-Id

Указывает идентификатор часового пояса, который устанавливает этот командлет.

Тип :: String
Позиция:: Именованный
Значение по умолчанию:: None
Необходимый:: True
Примите ввод конвейера:: True
Принимайте подстановочные знаки:: False

-InputObject

Указывает объект TimeZoneInfo, который будет использоваться в качестве входных данных.

Тип :: Информация о часовом поясе
Позиция:: 0
Значение по умолчанию:: None
Необходимый:: True
Примите ввод конвейера:: True
Принимайте подстановочные знаки:: False

-Name

Указывает имя часового пояса, устанавливаемого этим командлетом. Полный список названий часовых поясов можно получить, выполнив следующую команду: Get-TimeZone -ListAvailable.

Тип :: String
Позиция:: 0
Значение по умолчанию:: None
Необходимый:: True
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

-PassThru

Возвращает объект, представляющий элемент, с которым вы работаете. По умолчанию этот командлет не генерирует никаких выходных данных.

Тип :: SwitchParameter
Позиция:: Именованный
Значение по умолчанию:: None
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

-WhatIf

Показывает, что произойдет, если командлет запустится. Командлет не запускается.

Тип :: SwitchParameter
Псевдонимы:: wi
Позиция:: Именованный
Значение по умолчанию:: False
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

Входы

Строка

TimeZoneInfo

Выходы

Нет

По умолчанию этот командлет не возвращает никаких результатов.

TimeZoneInfo

При использовании параметра PassThru этот командлет возвращает объект TimeZoneInfo.

Примечания

PowerShell включает следующие псевдонимы для Set-TimeZone:

Windows:

Этот командлет доступен только на платформах Windows.