Cambia l'ora del sistema del computer in un'ora specificata dall'utente.
Sintassi
Set-Date [-Adjust] <TimeSpan> [-DisplayHint {<Date> | <Time> | <DateTime>}] [-Confirm] [-WhatIf] [<CommonParameters>]
Set-Date [-Data] <DateTime> [-DisplayHint {<Date> | <Time> | <DateTime>}] [-Confirm] [-WhatIf] [<CommonParameters>]
Descrizione
Il cmdlet Set-Date consente di cambiare la data e l'ora del sistema del computer in una data e un'ora specificata dall'utente. È possibile specificare una nuova data e/o ora digitando una stringa oppure 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 Adjust.
Parametri
-Adjust <TimeSpan>
Aggiunge o sottrae il valore specificato dalla data e dall'ora corrente. È possibile digitare un nuovo orario nel formato di data e ora standard per le impostazioni internazionali in uso oppure utilizzare il parametro Adjust per passare un oggetto TimeSpan da New-TimeSpan a Set-Date.
|
Obbligatorio? |
true |
|
Posizione? |
1 |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByPropertyName) |
|
Accettare caratteri jolly? |
false |
-Data <DateTime>
Cambia la data e l'ora nei valori specificati. È possibile digitare una nuova data nel formato breve e un'ora nel formato standard per le impostazioni internazionali in uso. In alternativa, è possibile passare un oggetto Date-Time da Get-Date.
Se si specifica una data, ma non un'ora, Set-Date imposta l'ora sulla mezzanotte della data specificata. Se si specifica solo l'ora, la data non verrà modificata.
|
Obbligatorio? |
true |
|
Posizione? |
1 |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByValue, ByPropertyName) |
|
Accettare caratteri jolly? |
false |
-DisplayHint <DisplayHintType>
Determina gli elementi della data e dell'ora che vengono visualizzati.
I valori validi sono:
-- date: visualizza solo la data
-- time: visualizza solo l'ora
-- datetime: visualizza la data e l'ora
Questo parametro interessa solo la visualizzazione. Non influisce sull'oggetto DateTime recuperato da Get-Date.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Confirm
Chiede una conferma prima di eseguire il comando.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-WhatIf
Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
<CommonParameters>
Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.
Input e output
Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.
|
Input |
System.DateTime È possibile reindirizzare una data a Set-Date. |
|
Output |
System.DateTime Set-Date restituisce un oggetto che rappresenta la data impostata. |
Note
Utilizzare questo cmdlet con cautela. La modifica della data e dell'ora potrebbe impedire al computer di ricevere eventi e aggiornamenti a livello di sistema che vengono attivati in base a una data o a un'ora specifica. Utilizzare i parametri -WhatIf e -Confirm per evitare errori.
È possibile utilizzare metodi .NET standard con oggetti DateTime e TimeSpan utilizzati con Set-Date, ad esempio AddDays, AddMonths e FromFileTime. Per ulteriori informazioni, vedere "DateTime Methods" e "TimeSpan Methods."
Esempio 1
C:\PS>Set-Date -Date (Get-Date).AddDays(3) Descrizione ----------- Tramite questo comando verranno aggiunti tre giorni alla data del sistema corrente. La modifica non influirà sull'ora. Verrà utilizzato il parametro Date per specificare la data. Verrà quindi utilizzato il cmdlet Get-Date per ottenere la data e l'ora correnti e verrà applicato il metodo AddDays di .NET per gli oggetti DateTime il cui valore è 3 (giorni).
Esempio 2
C:\PS>set-date -adjust -0:10:0 -displayHint time Descrizione ----------- Tramite questo comando l'ora corrente del sistema verrà riportata indietro di 10 minuti. Verrà utilizzato il parametro Adjust per specificare un intervallo di modifica e la variazione dell'ora (meno 10 minuti) nel formato dell'ora standard per le impostazioni internazionali. Il parametro DisplayHint indicherà a Windows PowerShell di visualizzare solo l'ora, ma non influirà sull'oggetto DateTime restituito da Set-Date.
Esempio 3
C:\PS>$t = get-date C:\PS>set-date -date $t Descrizione ----------- Tramite questi comandi la data e l'ora del sistema del computer verranno modificate in quelle salvate nella variabile $t. Tramite il primo comando la data verrà ottenuta e archiviata in $t. Nel secondo comando verrà utilizzato il parametro Date per passare al cmdlet Set-Date l'oggetto DateTime archiviato in $t.
Esempio 4
C:\PS>$90mins = new-timespan -minutes 90 C:\PS>set-date -adjust $90mins Descrizione ----------- Tramite questi comandi l'ora del sistema del computer locale verrà spostata in avanti di 90 minuti. Nel primo comando verrà utilizzato il cmdlet New-Timespan per creare un oggetto TimeSpan con un intervallo di 90 minuti. L'oggetto TimeSpan verrà quindi salvato nella variabile $90mins. Nel secondo comando verrà utilizzato il parametro Adjust di Set-Date per regolare la data in base al valore dell'oggetto TimeSpan archiviato nella variabile $90mins.
Vedere anche