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

구문

Set-Date [-Adjust] <TimeSpan> [-DisplayHint {<Date> | <Time> | <DateTime>}] [-Confirm] [-WhatIf] [<CommonParameters>]

Set-Date [-날짜] <DateTime> [-DisplayHint {<Date> | <Time> | <DateTime>}] [-Confirm] [-WhatIf] [<CommonParameters>]

설명

Set-Date cmdlet은 컴퓨터의 시스템 날짜 및 시간을 지정한 날짜 및 시간으로 변경합니다. 문자열을 입력하거나 DateTime 또는 TimeSpan 개체를 Set-Date로 전달하여 새로운 날짜 및/또는 시간을 지정할 수 있습니다. 새 날짜나 시간을 지정하려면 Date 매개 변수를 사용하십시오. 변경 간격을 지정하려면 Adjust 매개 변수를 사용하십시오.

매개 변수

-Adjust <TimeSpan>

현재 날짜 및 시간에서 지정한 값을 더하거나 뺍니다. 로캘의 표준 날짜 및 시간 형식에 조정 사항을 입력하거나 Adjust 매개 변수를 사용하여 New-TimeSpan에서 Set-Date로 TimeSpan 개체를 전달할 수 있습니다.

필수 여부

true

위치

1

기본값

파이프라인 입력 적용 여부

true (ByPropertyName)

와일드카드 문자 적용 여부

false

-날짜 <DateTime>

날짜 및 시간을 지정된 값으로 변경합니다. 새 날짜를 간단한 날짜 형식으로 입력하고 시간을 사용 중인 로캘의 표준 시간 형식으로 입력할 수 있습니다. 또는 Get-Date에서 Date-Time 개체를 전달할 수 있습니다.

시간은 제외하고 날짜만 지정하면 Set-Date가 시간을 지정한 날짜의 자정으로 변경합니다. 시간만 지정하는 경우 날짜는 변경되지 않습니다.

필수 여부

true

위치

1

기본값

파이프라인 입력 적용 여부

true (ByValue, ByPropertyName)

와일드카드 문자 적용 여부

false

-DisplayHint <DisplayHintType>

표시되는 날짜 및 시간 요소를 결정합니다.

유효한 값은 다음과 같습니다.

-- date: 날짜만 표시합니다.

-- time: 시간만 표시합니다.

-- datetime: 날짜와 시간을 표시합니다.

이 매개 변수는 표시에만 영향을 주고 Get-Date가 검색하는 DateTime 개체에는 영향을 주지 않습니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Confirm

명령을 실행하기 전에 확인 메시지를 표시합니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-WhatIf

명령을 실제로 실행하지 않고도 명령이 실행될 경우 발생할 수 있는 현상을 설명합니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

<CommonParameters>

이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_Commonparameters.

입력 및 출력

입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.

입력

System.DateTime

날짜를 Set-Date로 파이프할 수 있습니다.

출력

System.DateTime

Set-Date에서 설정하는 날짜를 나타내는 개체를 반환합니다.

참고

이 cmdlet은 주의하여 사용하십시오. 컴퓨터의 날짜 및 시간 변경. 이 변경 내용으로 인해 컴퓨터가 시스템 전체 이벤트 및 날짜나 시간에 따라 트리거되는 업데이트를 받지 못할 수 있습니다. 오류를 방지하려면 -WhatIf 및 -Confirm 매개 변수를 사용하십시오.

AddDays, AddMonths 및 FromFileTime 같은 Set-Date와 함께 사용되는 DateTime 및 TimeSpan 개체에 표준 .NET 메서드를 사용할 수 있습니다. 자세한 내용은 "DateTime Methods" 및 "TimeSpan Methods"를 참조하십시오.

예 1

C:\PS>Set-Date -Date (Get-Date).AddDays(3)

설명
-----------
이 명령은 현재 시스템 날짜에 3일을 추가합니다. 시간에는 영향을 주지 않습니다. 이 명령은 Date 매개 변수를 사용하여 날짜를 지정합니다. Get-Date cmdlet을 사용하여 현재 날짜 및 시간을 가져오고 값이 3(일)인 DateTime 개체에 AddDays .NET 메서드를 적용합니다.






예 2

C:\PS>set-date -adjust -0:10:0 -displayHint time

설명
-----------
이 명령은 현재 시스템 시간을 10분 전으로 설정합니다. Adjust 매개 변수를 사용하여 로캘의 표준 시간 형식에서 변경 간격 및 시간 변경 내용(10분 빼기)을 지정합니다. DisplayHint 매개 변수는 Windows PowerShell에 시간만 표시하도록 지시하지만 Set-Date가 반환하는 DateTime 개체에는 영향을 주지 않습니다.






예 3

C:\PS>$t = get-date

C:\PS>set-date -date $t

설명
-----------
이들 명령은 컴퓨터의 시스템 날짜 및 시간을 $t 변수에 저장된 날짜 및 시간으로 변경합니다. 첫 번째 명령은 날짜를 가져와 $t에 저장합니다. 두 번째 명령은 Date 매개 변수를 사용하여 $t에 있는 DateTime 개체를 Set-Date cmdlet으로 전달합니다.






예 4

C:\PS>$90mins = new-timespan -minutes 90

C:\PS>set-date -adjust $90mins

설명
-----------
이들 명령은 로컬 컴퓨터의 시스템 시간을 90분 전으로 설정합니다. 첫 번째 명령은 New-Timespan cmdlet을 사용하여 90분 간격의 TimeSpan 개체를 만든 다음 $90mins 변수에 TimeSpan 개체를 저장합니다. 두 번째 명령은 Set-Date의 Adjust 매개 변수를 사용하여 $90mins 변수의 TimeSpan 개체 값에 따라 날짜를 조정합니다.






참고 항목




목차