Partilhar via

Set-TimeZone

  • Referência
Módulo:
Microsoft.PowerShell.Management

Define o fuso horário do sistema como um fuso horário especificado.

Sintaxe

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

Description

Este cmdlet só está disponível na plataforma Windows.

O cmdlet Set-TimeZone define o fuso horário do sistema como um fuso horário especificado.

Exemplos

Exemplo 1: Definir o fuso horário por Id

Este exemplo define o fuso horário no computador local como 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

Exemplo 2: Definir o fuso horário por nome

Este exemplo define o fuso horário no computador local como UTC.

Set-TimeZone -Name 'Coordinated Universal Time' -PassThru

Como vimos no exemplo anterior, a de ID de e a de Nome do Fuso Horário nem sempre coincidem. O parâmetro Name deve corresponder às propriedades StandardName ou DaylightName do objeto TimeZoneInfo.

Observação

Os nomes de fuso horário podem variar de acordo com as configurações de Cultura no Windows. Este exemplo mostra os valores de um sistema definido como en-US.

Exemplo 3 - Listar todos os fusos horários disponíveis

Uma lista completa de IDs de fuso horário pode ser obtida executando o seguinte comando:

Get-TimeZone -ListAvailable

Parâmetros

-Confirm

Solicita confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Id

Especifica a ID do fuso horário definido por esse cmdlet.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-InputObject

Especifica um objeto de TimeZoneInfo a ser usado como entrada.

Tipo:TimeZoneInfo
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Name

Especifica o nome do fuso horário definido por esse cmdlet. Uma lista completa de nomes de fuso horário pode ser obtida executando o seguinte comando: Get-TimeZone -ListAvailable.

Tipo:String
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PassThru

Retorna um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet não gera nenhuma saída.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

String

TimeZoneInfo

Saídas

None

Por padrão, esse cmdlet não retorna nenhuma saída.

TimeZoneInfo

Quando você usa o parâmetro PassThru, esse cmdlet retorna um objeto TimeZoneInfo.

Notas

O PowerShell inclui os seguintes aliases para Set-TimeZone:

  • Janelas:
    • stz

Este cmdlet só está disponível em plataformas Windows.