Set-Date

Modul:

Microsoft.PowerShell.Utility Module

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

Syntax

Date (Alapértelmezett)

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

Adjust

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őt megadhat egy sztring beírásával, vagy egy DateTime vagy TimeSpan objektum Set-Date. Új dátum vagy idő megadásához használja a Dátum paramétert. A módosítási időköz megadásához használja a módosítása 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 megadásához a Dátum paramétert használja.

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ása paraméterrel a területi beállítás szokásos időformátumában megadhat egy változási időközt (mínusz tíz percet).

A DisplayHint paraméter arra utasítja a PowerShellt, hogy csak az időt jelenítse meg, de nem befolyásolja a visszaadottSet-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 rendszer dátumát és idejét a $Tváltozóban mentett dátumra és időre módosítják. Az első parancs lekéri a dátumot, és $Ttárolja.

A második parancs a Date paraméter használatával adja át a $T objektumá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 beállítási paraméterével állítja be a dátumot a változó TimeSpan objektumának é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.

Paramétertulajdonságok

Típus:	TimeSpan
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

Adjust

Position:	0
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-Confirm

Megerősítést kér a parancsmag futtatása előtt.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Cf

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	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 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.

Paramétertulajdonságok

Típus:	DateTime
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

Date

Position:	0
Kötelező:	True
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	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-DateDateTime objektumra.

Paramétertulajdonságok

Típus:	DisplayHintType
Alapértelmezett érték:	None
Elfogadott értékek:	Date, Time, DateTime
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-WhatIf

Megjeleníti, mi történne, ha a parancsmag futna. A parancsprogram nem lett futtatva.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Wi

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

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 Erősítse meg paramétereket.
• Standard .NET-metódusokat használhat a DateTime és TimeSpan objektumokkal, amelyeket a Set-Datehasznál, például AddDays, AddMonthsés FromFileTime. További információ: DateTime Metódusok és TimeSpan metódusok a .NET SDK-ban.

Kapcsolódó hivatkozások

• Get-Date
• New-TimeSpan