Set-TimeZone

Referência

Módulo:: Microsoft.PowerShell.Management

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

Syntax

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, a 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 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 sua confirmação antes de executar o cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-InputObject

Especifica um objeto TimeZoneInfo a ser usado como entrada.

Type:	TimeZoneInfo
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	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.

Type:	String
Position:	0
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Entradas

System.String, System.TimeZoneInfo, System.String

Observações

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

Get-TimeZone