다음을 통해 공유

Set-Date

  • 참조
모듈:
Microsoft.PowerShell.Utility

컴퓨터의 시스템 시간을 지정한 시간으로 변경합니다.

구문

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

Description

cmdlet은 Set-Date 컴퓨터의 시스템 날짜와 시간을 지정한 날짜 및 시간으로 변경합니다.

문자열을 입력하거나 DateTime 또는 TimeSpan 개체Set-Date를 전달하여 새 날짜 및/또는 시간을 지정할 수 있습니다. 새 날짜 또는 시간을 지정하려면 Date 매개 변수를 사용합니다. 변경 간격을 지정하려면 Adjust 매개 변수를 사용합니다.

시스템 날짜 및 시간을 변경하려면 관리자 권한이 있어야 합니다. Windows에서 관리자 권한으로 실행 옵션을 사용하여 PowerShell을 시작합니다.

예제

예제 1: 시스템 날짜에 3일 추가

이 명령은 현재 시스템 날짜에 3일을 더합니다. 시간에 영향을 주지 않습니다. 이 명령은 Date 매개 변수를 사용하여 날짜를 지정합니다.

cmdlet은 Get-Date 현재 날짜를 DateTime 개체로 반환합니다. DateTime 개체의 AddDays 메서드는 현재 DateTime 개체에 지정된 일 수(3)를 추가합니다.

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

예제 2: 시스템 클록을 10분 뒤로 설정

다음은 현재 시스템 시간을 10분으로 설정하는 예제입니다.

Adjust 매개 변수를 사용하면 로캘의 표준 시간 형식으로 변경 간격(10분 제외)을 지정할 수 있습니다.

DisplayHint 매개 변수는 PowerShell에 시간만 표시하도록 지시하지만 반환되는 Set-Date DateTime 개체에는 영향을 주지 않습니다.

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

예제 3: 날짜 및 시간을 변수 값으로 설정

이러한 명령은 로컬 컴퓨터의 시스템 날짜와 시간을 변수 $T에 저장된 날짜 및 시간으로 변경합니다. 첫 번째 명령은 날짜를 가져오고 저장합니다 $T.

두 번째 명령은 Date 매개 변수를 사용하여 DateTime 개체를 cmdlet에 Set-Date $T 전달합니다.

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

예제 4: 시스템 클록에 90분 추가

이 명령은 로컬 컴퓨터의 시스템 시간을 90분 후로 설정합니다.

첫 번째 명령은 cmdlet을 New-TimeSpan 사용하여 90분 간격으로 TimeSpan 개체를 만들고 변수에 $90mins 저장합니다.

두 번째 명령은 Adjust 매개 변수를 사용하여 변수의 Set-Date TimeSpan 개체 값으로 날짜를 조정합니다$90mins.

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

5: 특정 날짜 및 시간으로 변경

다음 예제에서는 날짜와 시간을 특정 값으로 설정합니다.

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

매개 변수

-Adjust

이 cmdlet이 현재 날짜 및 시간을 추가하거나 뺄 값을 지정합니다. 로캘에 대한 표준 날짜 및 시간 형식으로 조정을 입력하거나 Adjust 매개 변수를 사용하여 TimeSpan 개체 New-TimeSpan 를 전달합니다Set-Date.

형식:TimeSpan
Position:0
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

형식:SwitchParameter
별칭:cf
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Date

날짜와 시간을 지정된 값으로 변경합니다. 새 날짜를 짧은 날짜 형식으로 입력하고 로캘의 표준 시간 형식으로 시간을 입력할 수 있습니다. 또는 .에서 Get-DateDateTime 개체를 전달할 수 있습니다.

시간을 Set-Date 지정하지 않고 날짜를 지정하면 지정된 날짜의 시간을 자정으로 변경합니다. 시간만 지정하면 날짜가 변경되지 않습니다.

형식:DateTime
Position:0
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-DisplayHint

표시되는 날짜 및 시간의 요소를 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

  • Date - 날짜만 표시합니다.
  • Time - 시간만 표시합니다.
  • DateTime - 날짜 및 시간을 표시합니다.

이 매개 변수는 디스플레이에만 영향을 줍니다. 검색하는 DateTime 개체 Get-Date 에는 영향을 주지 않습니다.

형식:DisplayHintType
허용되는 값:Date, Time, DateTime
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

형식:SwitchParameter
별칭:wi
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

DateTime

날짜를 이 cmdlet으로 파이프할 수 있습니다.

출력

DateTime

이 cmdlet은 설정한 날짜를 나타내는 개체를 반환합니다.

참고

  • 컴퓨터에서 날짜 및 시간을 변경할 때 이 cmdlet을 신중하게 사용합니다. 이 변경 내용으로 인해 컴퓨터가 날짜 또는 시간에 의해 트리거되는 시스템 전체 이벤트 및 업데이트를 받지 못할 수 있습니다. WhatIf 및 Confirm 매개 변수를 사용하여 오류를 방지합니다.
  • AddDays, AddMonths 및 FromFileTime과 같은 DateTime 및 TimeSpan 개체와 함께 Set-Date표준 .NET 메서드를 사용할 수 있습니다. 자세한 내용은 .NET SDK의 DateTime 메서드 및 TimeSpan 메서드 를 참조하세요.