Set-TimeZone

Módulo:

Microsoft.PowerShell.Management Module

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

Sintaxe

Name (Predefinição)

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>]

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.

Propriedades dos parâmetros

Tipo:	SwitchParameter
Default value:	False
Suporta carateres universais:	False
NãoMostrar:	False
Aliases:	Cf.

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-Id

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

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

Id

Position:	Named
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-InputObject

Especifica um objeto de TimeZoneInfo a ser usado como entrada.

Propriedades dos parâmetros

Tipo:	TimeZoneInfo
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

InputObject

Position:	0
Obrigatório:	True
Valor do pipeline:	True
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	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.

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

Name

Position:	0
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	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.

Propriedades dos parâmetros

Tipo:	SwitchParameter
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-WhatIf

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

Propriedades dos parâmetros

Tipo:	SwitchParameter
Default value:	False
Suporta carateres universais:	False
NãoMostrar:	False
Aliases:	Wi

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

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.

Ligações Relacionadas

• Get-TimeZone