Compartilhar via

Set-TimeZone

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

Define o fuso horário do sistema para 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

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

O Set-TimeZone cmdlet 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, o Id e o Nome do Fuso Horário nem sempre correspondem. O parâmetro Name deve corresponder às propriedades StandardName ou DaylightName do objeto TimeZoneInfo .

Observação

Os nomes dos fusos horários 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 sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Id

Especifica a ID do fuso horário que esse cmdlet define.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-InputObject

Especifica um objeto TimeZoneInfo a ser usado como entrada.

Tipo:TimeZoneInfo
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Name

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

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PassThru

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 .

Observações

O PowerShell inclui os seguintes aliases para Set-TimeZone:

  • Windows:
    • stz

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