Set-Date
Cambia 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 Set-Date
cmdlet modifica la data e l'ora di sistema nel computer in una data e un'ora specificata.
È 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, usare il parametro Date .
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 sull'ora. Il comando usa 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 impostato il tempo di sistema corrente indietro di 10 minuti.
Il parametro Regola consente di specificare un intervallo di modifica (meno dieci minuti) nel formato orario standard per le impostazioni locali.
Il parametro DisplayHint indica a PowerShell di visualizzare solo l'ora, ma non influisce sull'oggetto DateTime che Set-Date
restituisce.
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 alla data e all'ora salvata nella variabile $T
. Il primo comando ottiene la data e lo archivia in $T
.
Il secondo comando usa il parametro Date per passare l'oggetto $T
DateTime al Set-Date
cmdlet.
$T = Get-Date
Set-Date -Date $T
Esempio 4: Aggiungere 90 minuti all'orologio di sistema
Questi comandi spostano l'ora di sistema nel computer locale in avanti di 90 minuti.
Il primo comando usa il New-TimeSpan
cmdlet per creare un oggetto TimeSpan con un intervallo di 90 minuti e lo salva nella $90mins
variabile.
Il secondo comando usa il parametro Regola di Set-Date
per modificare la data in base al valore dell'oggetto TimeSpan nella $90mins
variabile.
$90mins = New-TimeSpan -Minutes 90
Set-Date -Adjust $90mins
Parametri
-Adjust
Specifica il valore per cui questo cmdlet aggiunge o sottrae dalla data e dall'ora correnti.
può digitare una regolazione in formato data e ora standard per le impostazioni locali o usare il parametro Regola per passare un oggetto TimeSpan da New-TimeSpan
a Set-Date
.
Type: | TimeSpan |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Richiede la conferma dell'utente prima di eseguire il cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Date
Cambia la data e l'ora nei valori specificati.
È possibile digitare una nuova data nel formato di data breve e un'ora nel formato di ora standard per le impostazioni locali correnti. 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 a mezzanotte nella data specificata. Se si specifica solo un'ora, la data non verrà modificata.
Type: | DateTime |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DisplayHint
Specifica quali elementi della data e dell'ora vengono 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 ha effetto solo sulla visualizzazione.
Non influisce sull'oggetto DateTime che Get-Date
recupera.
Type: | DisplayHintType |
Accepted values: | Date, Time, DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Input
È possibile inviare una pipe a questo cmdlet.
Output
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. potrebbe impedire al computer di ricevere gli aggiornamenti e gli eventi a livello di sistema attivati da una data o un'ora. Usare i parametri WhatIf e Conferma per evitare errori.
- È possibile usare metodi .NET standard con gli oggetti DateTime e TimeSpan usati con
Set-Date
, ad esempio AddDays, AddMonths e FromFileTime. Per altre informazioni, vedere Metodi DateTime e Metodi TimeSpan in .NET SDK.