Condividi tramite

Set-Date

Modulo:
Microsoft.PowerShell.Utility Module

Modifica l'ora di sistema nel computer in un'ora specificata dall'utente.

Sintassi

Date (impostazione predefinita). 

Set-Date
    [-Date] <DateTime>
    [-DisplayHint <DisplayHintType>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Adjust 

Set-Date
    [-Adjust] <TimeSpan>
    [-DisplayHint <DisplayHintType>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Descrizione

Il Set-Date cmdlet modifica la data e l'ora di sistema nel computer in una data e un'ora specificate dall'utente.

È possibile specificare una nuova data e/o ora digitando una stringa o passando un oggetto DateTime o TimeSpan a Set-Date. Per specificare una nuova data o ora, utilizzare il parametro Date . Per specificare un intervallo di modifica, utilizzare il parametro Regola .

È necessario disporre dei diritti amministrativi per modificare la data e l'ora del sistema. In Windows avviare PowerShell con l'opzione Esegui come amministratore .

Esempio

Esempio 1: aggiungere tre giorni alla data di sistema

Questo comando aggiunge tre giorni alla data di sistema corrente. Non influisce sul tempo. Il comando utilizza il parametro Date per specificare la data.

Il Get-Date cmdlet restituisce la data corrente come oggetto DateTime . Il metodo AddDays dell'oggetto DateTime aggiunge un numero specificato di giorni (3) all'oggetto DateTime corrente.

Set-Date -Date (Get-Date).AddDays(3)

Esempio 2: Impostare l'orologio di sistema indietro di 10 minuti

In questo esempio viene impostata l'ora di sistema corrente di 10 minuti.

Il parametro Adjust consente di specificare un intervallo di modifica (meno dieci minuti) nel formato dell'ora standard per le impostazioni internazionali.

Il parametro DisplayHint indica a PowerShell di visualizzare solo l'ora, ma non influisce sull'oggetto DateTime restituito Set-Date .

Set-Date -Adjust -0:10:0 -DisplayHint Time

Esempio 3: Impostare la data e l'ora su un valore variabile

Questi comandi modificano la data e l'ora del sistema sul computer locale con la data e l'ora salvate nella variabile $T. Il primo comando ottiene la data e la memorizza in $T.

Il secondo comando utilizza il parametro Date per passare l'oggetto DateTime al $TSet-Date cmdlet.

$T = Get-Date
Set-Date -Date $T

Esempio 4: Aggiungere 90 minuti all'orologio di sistema

Questi comandi fanno avanzare l'ora di sistema nel computer locale di 90 minuti.

Il primo comando utilizza il New-TimeSpan cmdlet per creare un oggetto TimeSpan con un intervallo di 90 minuti e lo salva nella $90mins variabile.

Il secondo comando utilizza il parametro Adjust di Set-Date per regolare la data in base al valore dell'oggetto TimeSpan nella $90mins variabile.

$90mins = New-TimeSpan -Minutes 90
Set-Date -Adjust $90mins

5: Passare a una data e un'ora specifiche

Nell'esempio seguente la data e l'ora vengono impostate su un valore specifico.

PS> Get-Date

Monday, June 10, 2024 2:05:48 PM

PS> Set-Date '6/11/2024 2:05:48 PM'

Tuesday, June 11, 2024 2:05:48 PM

Parametri

-Adjust

Specifica il valore per il quale questo cmdlet aggiunge o sottrae dalla data e dall'ora correnti. È possibile digitare una regolazione nel formato di data e ora standard per le impostazioni locali oppure usare il parametro Adjust per passare un oggetto TimeSpan da New-TimeSpan a Set-Date.

Proprietà dei parametri

Tipo:TimeSpan
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Adjust
Posizione:0
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False
Alias:cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Date

Modifica la data e l'ora in base ai valori specificati. È possibile digitare una nuova data nel formato di data breve e un'ora nel formato di ora standard per le impostazioni locali. In alternativa, è possibile passare un oggetto DateTime da Get-Date.

Se si specifica una data, ma non un'ora, Set-Date l'ora viene modificata alla mezzanotte della data specificata. Se si specifica solo un'ora, la data non viene modificata.

Proprietà dei parametri

Tipo:DateTime
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Date
Posizione:0
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-DisplayHint

Specifica gli elementi della data e dell'ora visualizzati. I valori accettabili per questo parametro sono:

  • Date : visualizza solo la data.
  • Time - visualizza solo l'ora.
  • DateTime : visualizza la data e l'ora.

Questo parametro influisce solo sulla visualizzazione. Non influisce sull'oggetto DateTime che Get-Date recupera.

Proprietà dei parametri

Tipo:DisplayHintType
Valore predefinito:None
Valori accettati:Date, Time, DateTime
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False
Alias:Wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

DateTime

È possibile inviare tramite pipe una data a questo cmdlet.

Output

DateTime

Questo cmdlet restituisce un oggetto che rappresenta la data impostata.

Note

  • Utilizzare questo cmdlet con cautela quando si modificano la data e l'ora nel computer. La modifica potrebbe impedire al computer di ricevere eventi e aggiornamenti a livello di sistema attivati da una data o un'ora. Utilizza i parametri WhatIf e Confirm per evitare errori.
  • È possibile utilizzare i metodi .NET standard con gli oggetti DateTime e TimeSpan utilizzati con Set-Date, ad esempio AddDays, AddMonths e FromFileTime. Per altre informazioni, vedere Metodi DateTime e metodi TimeSpan in .NET SDK.