New-SCServicingWindow

모듈:

VirtualMachineManager

서비스 창 및 서비스 창에 대한 일정을 만듭니다.

Syntax

New-SCServicingWindow
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-Description <String>]
   [-Category <String>]
   [-Owner <String>]
   [-TimeZone <Int32>]
   [-StartDate <DateTime>]
   [-StartTimeOfDay <DateTime>]
   -WeeklyScheduleDayOfWeek <String>
   [-WeeksToRecur <Int32>]
   [-MinutesDuration <Int32>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

New-SCServicingWindow
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-Description <String>]
   [-Category <String>]
   [-Owner <String>]
   [-TimeZone <Int32>]
   [-StartDate <DateTime>]
   [-StartTimeOfDay <DateTime>]
   -MonthlyScheduleDayOfWeek <DayOfWeek>
   -WeekOfMonth <WeekOfMonthType>
   [-MonthsToRecur <Int32>]
   [-MinutesDuration <Int32>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

New-SCServicingWindow
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-Description <String>]
   [-Category <String>]
   [-Owner <String>]
   [-TimeZone <Int32>]
   [-StartDate <DateTime>]
   [-StartTimeOfDay <DateTime>]
   -DayOfMonth <DayOfMonthType>
   [-MonthsToRecur <Int32>]
   [-MinutesDuration <Int32>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

New-SCServicingWindow
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-Description <String>]
   [-Category <String>]
   [-Owner <String>]
   [-TimeZone <Int32>]
   [-StartDate <DateTime>]
   [-StartTimeOfDay <DateTime>]
   -DaysToRecur <Int32>
   [-MinutesDuration <Int32>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

New-SCServicingWindow cmdlet은 서비스 창과 서비스 창에 대한 일정을 만듭니다. 서비스 기간은 가상 머신, 호스트 또는 서비스에서 유지 관리 작업을 수행할 수 있는 예약된 기간입니다.

예제

예제 1: 일일 서비스 기간 예약

PS C:\> $Date = (Get-Date).AddDays(2)
PS C:\> New-SCServicingWindow -Name "Backup Staging A" -Category "Non Essential" -StartDate $Date -StartTimeOfDay "13:30" -TimeZone 085 -DaysToRecur 3

첫 번째 명령은 현재 날짜를 가져오고 2일을 추가한 다음 결과를 $Date 변수에 저장합니다.

두 번째 명령은 GMT 표준 표준 시간대에서 오후 1시 30분에 3일마다 발생하는 백업 준비 A라는 서비스 창을 만듭니다. 서비스 창의 시작 날짜는 $Date 저장된 날짜(2일)로 설정됩니다.

예제 2: 일주일에 하루씩 발생하는 서비스 기간 예약

PS C:\> $Date = (Get-Date).AddDays(7)
PS C:\> New-SCServicingWindow -Name "Test Servers Group 3" -Category "Test Group" -StartDate $Date -StartTimeOfDay "11:00" -TimeZone 035 -WeeklyScheduleDayOfWeek "Saturday" -WeeksToRecur 1 -MinutesDuration 180

첫 번째 명령은 현재 날짜를 가져오고 7일(1주일)을 추가한 다음 결과를 $Date 변수에 저장합니다.

두 번째 명령은 동부 표준 시간대에서 매주 토요일 오전 11시부터 시작하여 3시간(180분)동안 지속되는 테스트 서버 그룹 3이라는 서비스 창을 만듭니다. 서비스 창의 시작 날짜는 $Date 저장된 날짜(7일(1주일)로 설정됩니다.

예제 3: 격주 서비스 기간 예약

PS C:\> New-SCServicingWindow -Name "Staging Group C" -StartTimeOfDay "22:30" -TimeZone 035 -WeeklyScheduleDayOfWeek "Saturday, Sunday" -WeeksToRecur 2

이 명령은 동부 표준 시간대에서 토요일과 일요일 오후 10시 30분부터 격주(격주)에 발생하는 스테이징 그룹 C라는 서비스 창을 만듭니다. 시작 날짜가 지정되지 않으므로 기본적으로 서비스 창이 오늘부터 적용됩니다.

예제 4: 격월 서비스 기간 예약

PS C:\> New-SCServicingWindow -Name "Production Servers A" -Category "Emergency" -StartTimeOfDay "23:30" -TimeZone 085 -MonthlyScheduleDayOfWeek "Tuesday" -WeekOfMonth "Second" -MonthsToRecur 2

이 명령은 동부 표준 시간대의 오후 11시 30분부터 매월 두 번째 화요일에 격월(격월) 발생하는 프로덕션 서버 A라는 서비스 창을 만듭니다. 시작 날짜가 지정되지 않으므로 기본적으로 서비스 창이 오늘부터 적용됩니다.

매개 변수

-Category

서비스 창의 범주를 지정합니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DayOfMonth

일정이 시작되는 월의 서수 일을 지정합니다. 예를 들어 4는 해당 월의 4일을 나타냅니다. 마지막 날짜는 월의 마지막 날을 나타냅니다.

기본값은 StartDate 매개 변수에 지정된 날짜에 해당하는 정수입니다.

• 유효한 정수 값: 1 - 31
• 유효한 문자열 값: First, Last

Type:	DayOfMonthType
Accepted values:	First, DayTwo, DayThree, DayFour, DayFive, DaySix, DaySeven, DayEight, DayNine, DayTen, DayEleven, DayTweleve, DayThirteen, DayFourteen, DayFifteen, DaySixteen, DaySeventeen, DayEighteen, DayNineteen, DayTwenty, DayTwentyOne, DayTwentyTwo, DayTwentyThree, DayTwentyFour, DayTwentyFive, DayTwentySix, DayTwentySeven, DayTwentyEight, DayTwentyNine, DayThirty, DayThirtyOne, Last
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DaysToRecur

예약된 작업 사이의 시간(일)을 지정합니다. 기본값은 최소값 1(1)입니다. 최대값은 999입니다.

Type:	Int32
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

서비스 창에 대한 설명을 지정합니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-JobVariable

작업 진행률을 추적하여 이 매개 변수로 이름이 지정된 변수에 보관하도록 지정합니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MinutesDuration

시간(분)을 지정합니다. 이 매개 변수를 사용하여 서버 또는 서비스를 유지 관리 모드로 전환할 시간을 지정합니다.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MonthlyScheduleDayOfWeek

월별 일정에 따라 발생하는 작업을 실행할 요일을 지정합니다. 요일만 지정할 수 있습니다. 기본값은 현재 날짜입니다(오늘이 화요일인 경우 화요일이 기본값임). 이 매개 변수에 허용되는 값은 다음과 같습니다.

• 월요일
• 화요일
• 수요일
• 목요일
• 금요일
• 토요일
• 일요일

요구 사항: WeekOfMonth 매개 변수와 함께 사용합니다.

Type:	DayOfWeek
Accepted values:	Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-MonthsToRecur

예약된 서비스 기간 사이의 시간(월)을 지정합니다. 기본값은 최소값 1입니다. 최대 값이 없습니다.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

VMM(Virtual Machine Manager) 개체의 이름을 지정합니다.

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

-Owner

유효한 도메인 사용자 계정의 형태로 VMM 개체의 소유자를 지정합니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PROTipID

이 작업을 트리거한 PRO 팁(성능 및 리소스 최적화 팁)의 ID를 지정합니다. 이 매개 변수를 사용하면 PRO 팁을 감사할 수 있습니다.

Type:	Guid
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RunAsynchronously

컨트롤이 명령 셸로 즉시 반환되도록 작업이 비동기적으로 실행됨을 나타냅니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-StartDate

서비스 창을 시작할 날짜를 지정합니다. 기본값은 현재 날짜입니다. 새 날짜를 로캘의 짧은 날짜 형식으로 입력하거나 Get-Date에서 DateTime 개체를 전달할 수 있습니다.

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-StartTimeOfDay

작업 또는 기타 작업을 시작할 시간 또는 24시간 동안의 시간 범위를 지정합니다. 기본값은 현재 시간입니다.

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TimeZone

동일한 표준 시간을 공유하는 지리적 지역을 식별하는 숫자(인덱스)를 지정합니다. 표준 시간대 인덱스 목록은 Microsoft 표준 시간대 인덱스 값을 참조하세요http://go.microsoft.com/fwlink/?LinkId=120935. 표준 시간대가 지정되지 않은 경우 가상 머신에 사용되는 기본 표준 시간대는 가상 머신 호스트에 있는 표준 시간대 설정과 동일합니다.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VMMServer

VMM 서버 개체를 지정합니다.

Type:	ServerConnection
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-WeeklyScheduleDayOfWeek

작업을 실행할 요일을 하나 이상 지정합니다. 기본값은 현재 요일입니다.

• 문자열을 사용하여 개별 일을 지정하는 유효한 값: 월요일, 화요일, 수요일, 목요일, 금요일, 토요일, 일요일.
• 1주일의 일 집합을 지정하는 유효한 값: 쉼표로 구분된 2일 이상의 모든 일 집합입니다.
• 정수를 사용하여 개별 일을 지정하는 유효한 값: 1, 2, 3, 4, 5, 6, 7

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-WeekOfMonth

첫 번째, 두 번째, 세 번째, 네 번째 또는 마지막과 같이 월의 첫 번째 날을 기준으로 한 주를 지정합니다.

Type:	WeekOfMonthType
Accepted values:	First, Second, Third, Fourth, Last
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-WeeksToRecur

예약된 작업 사이의 시간(주)을 지정합니다. 기본값은 최소값 1(1)입니다. 최대 값이 없습니다.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

출력

ServicingWindow

이 cmdlet은 ServicingWindow 개체를 반환합니다.

관련 링크

• Get-SCServicingWindow
• Remove-SCServicingWindow
• Set-SCServicingWindow