Megosztás a következőn keresztül:

Set-Date

  • Referencia
Modul:
Microsoft.PowerShell.Utility

A számítógépen megadott időpontra módosítja a rendszeridőt.

Syntax

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

Description

A Set-Date parancsmag a számítógép rendszerdátumát és idejét egy Ön által megadott dátumra és időpontra módosítja.

Új dátumot és/vagy időpontot megadhat egy sztring beírásával, vagy egy DateTime vagy TimeSpan objektum Set-Dateátadásával. Új dátum vagy idő megadásához használja a Date paramétert. A módosítási időköz megadásához használja a Kiigazítás paramétert.

Rendszergazdai jogosultságokkal kell rendelkeznie a rendszer dátumának és időpontjának módosításához. Windows rendszeren indítsa el a PowerShellt a Futtatás rendszergazdaként lehetőséggel.

Példák

1. példa: Három nap hozzáadása a rendszer dátumához

Ez a parancs három napot ad hozzá az aktuális rendszerdátumhoz. Ez nem befolyásolja az időt. A parancs a Dátum paramétert használja a dátum megadásához.

A Get-Date parancsmag az aktuális dátumot adja vissza DateTime-objektumként. A DateTime objektum AddDays metódusa megadott számú napot (3) ad hozzá az aktuális DateTime objektumhoz.

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

2. példa: Állítsa vissza a rendszerórát 10 percre

Ez a példa 10 perccel állítja vissza az aktuális rendszeridőt.

A Beállítás paraméterrel megadhat egy változási időközt (mínusz tíz perc) a területi beállítás szokásos időformátumában.

A DisplayHint paraméter arra utasítja a PowerShellt, hogy csak az időt jelenítse meg, de nem befolyásolja a visszaadott Set-Date DateTime objektumot.

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

3. példa: Dátum és idő beállítása változó értékre

Ezek a parancsok a helyi számítógépen a változóban $Tmentett dátumra és időre módosítják a rendszer dátumát és idejét. Az első parancs lekéri a dátumot, és tárolja a következőben $T: .

A második parancs a Date paraméter használatával adja át a DateTime objektumot $T a Set-Date parancsmagnak.

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

4. példa: 90 perc hozzáadása a rendszerórához

Ezek a parancsok 90 perccel előreléptetik a rendszeridőt a helyi számítógépen.

Az első parancs a New-TimeSpan parancsmaggal hoz létre egy TimeSpan objektumot 90 perces időközzel, és menti a $90mins változóba.

A második parancs a Dátum beállítása paraméter Set-Date használatával módosítja a dátumot a változó TimeSpan objektumának $90mins értékével.

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

5: Váltás egy adott dátumra és időpontra

Az alábbi példa egy adott értékre állítja a dátumot és az időt.

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

Paraméterek

-Adjust

Azt az értéket adja meg, amelyhez a parancsmag hozzáadja vagy kivonja az aktuális dátumot és időt. Beírhat egy módosítást szabványos dátum- és időformátumban a területi beállításhoz, vagy a Beállítás paraméterrel átadhatja a TimeSpan objektumot a New-TimeSpan kezdő és a hely Set-Dateközött.

Típus:TimeSpan
Position:0
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

Típus:SwitchParameter
Aliasok:cf
Position:Named
Alapértelmezett érték:False
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Date

A dátumot és az időt a megadott értékekre módosítja. Beírhat egy új dátumot a rövid dátumformátumba, és egy időpontot a területi beállítás szokásos időformátumában. Vagy átadhat egy DateTime-objektumot is.Get-Date

Ha dátumot ad meg, de időpontot nem, Set-Date a megadott dátumon éjfélre módosítja az időpontot. Ha csak egy időpontot ad meg, az nem módosítja a dátumot.

Típus:DateTime
Position:0
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-DisplayHint

Megadja, hogy a dátum és az idő mely elemei jelenjenek meg. A paraméter elfogadható értékei a következők:

  • Date - csak a dátumot jeleníti meg.
  • Time - csak az időt jeleníti meg.
  • DateTime - megjeleníti a dátumot és az időt.

Ez a paraméter csak a megjelenítésre van hatással. Nincs hatással a beolvasható Get-Date DateTime objektumra.

Típus:DisplayHintType
Elfogadott értékek:Date, Time, DateTime
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

Típus:SwitchParameter
Aliasok:wi
Position:Named
Alapértelmezett érték:False
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

Bevitelek

DateTime

Dátumot erre a parancsmagra is beszűkítheti.

Kimenetek

DateTime

Ez a parancsmag egy olyan objektumot ad vissza, amely a beállított dátumot jelöli.

Jegyzetek

  • Ezt a parancsmagot óvatosan használja a számítógépen lévő dátum és idő módosításakor. A módosítás megakadályozhatja, hogy a számítógép rendszerszintű eseményeket és frissítéseket fogadjon, amelyeket egy dátum vagy idő aktivál. A hibák elkerülése érdekében használja a WhatIf és a Confirm paramétereket.
  • Standard .NET-metódusokat használhat az olyan DateTime- és TimeSpan-objektumokkalSet-Date, mint az AddDays, az AddMonths és a FromFileTime. További információ: DateTime Metódusok és TimeSpan metódusok a .NET SDK-ban.