Set-Date

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.

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

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 a területi beállítás szokásos dátum- és időformátumában, vagy a Beállítás paraméterrel átadhatja a TimeSpan objektumot a New-TimeSpan kezdő és a kezdő időpont között Set-Date.

Type:TimeSpan
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:DateTime
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 lekért DateTime objektumra Get-Date .

Type:DisplayHintType
Accepted values:Date, Time, DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.