Поделиться через


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.