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 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 coincidem. O parâmetro Name deve corresponder às propriedades StandardName ou DaylightName do objeto TimeZoneInfo .

Nota

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 a sua 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 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

Apresenta o que aconteceria mediante a execução do cmdlet. 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:

  • Windows:
    • stz

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