Condividi tramite

Set-Date

  • Riferimento
Modulo:
Microsoft.PowerShell.Utility

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

Sintassi

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

Descrizione

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

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

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 usa il parametro date per specificare la data.

Il cmdlet restituisce la data corrente come oggetto DateTime . Il metodo addDays dell'oggetto DateTime aggiunge un numero specificato di giorni () all'oggetto DateTime corrente.

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

Esempio 2: Impostare il clock di sistema indietro di 10 minuti

In questo esempio viene impostato il tempo di sistema corrente di 10 minuti.

Il parametro Regola consente di specificare un intervallo di modifica (meno dieci minuti) nel formato ora standard per le impostazioni locali.

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

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

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

Questi comandi modificano la data e l'ora di sistema nel computer locale impostando la data e l'ora salvate nella variabile $T. Il primo comando ottiene la data e la archivia in $T.

Il secondo comando usa il parametro Date per passare l'oggetto DateTime nel cmdlet .

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

Esempio 4: Aggiungere 90 minuti all'orologio di sistema

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

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

Il secondo comando usa il parametro Adjust di per modificare la data in base al valore dell'oggetto TimeSpan nella variabile .

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

Parametri

-Adjust

Specifica il valore per il quale questo cmdlet aggiunge o sottrae dalla data e dall'ora correnti. può digitare una regolazione nel formato di data e ora standard per le impostazioni locali o utilizzare il parametro regola per passare un oggetto timeSpan da a .

Tipo:TimeSpan
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Date

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

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

Tipo:DateTime
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly: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 recupera.

Tipo:DisplayHintType
Valori accettati:Date, Time, DateTime
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

DateTime

È possibile inviare tramite pipe una data a questo cmdlet.

Output

DateTime

Questo cmdlet restituisce un oggetto che rappresenta la data impostata.

Note

  • Usare questo cmdlet con cautela quando si modifica 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. Usare i parametri WhatIf e Confirm per evitare errori.
  • È possibile usare metodi .NET standard con gli oggetti DateTime e TimeSpan usati con , ad esempio AddDays, AddMonthse FromFileTime. Per altre informazioni, vedere metodi DateTime e metodi timeSpan in .NET SDK.