다음을 통해 공유

New-CMMaintenanceWindow

  • 참조
모듈:
ConfigurationManager

컬렉션에 대한 유지 관리 기간을 만듭니다.

구문

New-CMMaintenanceWindow
   [-ApplyTo <MaintenanceWindowApplyTo>]
   [-ApplyToSoftwareUpdateOnly]
   [-ApplyToTaskSequenceOnly]
   [-InputObject] <IResultObject>
   [-IsEnabled <Boolean>]
   [-IsUtc <Boolean>]
   -Name <String>
   -Schedule <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMMaintenanceWindow
   [-ApplyTo <MaintenanceWindowApplyTo>]
   [-ApplyToSoftwareUpdateOnly]
   [-ApplyToTaskSequenceOnly]
   [-CollectionId] <String>
   [-IsEnabled <Boolean>]
   [-IsUtc <Boolean>]
   -Name <String>
   -Schedule <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMMaintenanceWindow
   [-ApplyTo <MaintenanceWindowApplyTo>]
   [-ApplyToSoftwareUpdateOnly]
   [-ApplyToTaskSequenceOnly]
   [-CollectionName] <String>
   [-IsEnabled <Boolean>]
   [-IsUtc <Boolean>]
   -Name <String>
   -Schedule <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

이 cmdlet을 사용하여 컬렉션에 대한 유지 관리 기간을 만듭니다. 유지 관리 기간은 Configuration Manager 클라이언트가 작업을 실행할 수 있는 되풀이 기간입니다. 예를 들어 소프트웨어 업데이트를 적용하거나 소프트웨어를 설치합니다. 이 창에서는 중요한 시스템 변경이 생산성 및 작동 시간에 영향을 주지 않는 경우에만 발생합니다.

유지 관리 기간에 대한 자세한 내용은 Configuration Manager에서 유지 관리 기간을 사용하는 방법을 참조하세요.

참고

Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\>). 자세한 내용은 시작을 참조하세요.

예제

예제 1: 유지 관리 기간 만들기

첫 번째 명령은 New-CMSchedule cmdlet을 사용하여 일정 개체를 만든 다음 변수에 $MWSchedule 저장합니다.

두 번째 명령은 지정된 컬렉션에 대해 MonthlySchedule 이라는 유지 관리 기간을 만듭니다. 유지 관리 기간은 변수에 $MWSchedule 저장된 일정을 사용합니다.

$MWSchedule = New-CMSchedule -DayOfWeek Friday -DurationCount 1 -DurationInterval Hours -RecurCount 1 -Start "10/12/2013 21:00:00"
New-CMMaintenanceWindow -CollectionId "XYZ0005D" -Name "MonthlySchedule" -Schedule $MWSchedule

예제 2: 컬렉션 간에 유지 관리 기간 복사

첫 번째 명령은 ID XYZ0003F 있는 컬렉션에서 유지 관리 기간을 가져옵니다. 그런 다음 동일한 이름, 동일한 일정 및 소프트웨어 업데이트에 대해서만 ID XYZ0005D 사용하여 컬렉션에 유지 관리 기간을 만듭니다.

$mw1 = Get-CMMaintenanceWindow -CollectionId "XYZ0003F" -MaintenanceWindowName "nightly SUM window"
New-CMMaintenanceWindow -CollectionId "XYZ0005D" -Name $mw1.Name -Schedule (Convert-CMSchedule -ScheduleString $mw1.ServiceWindowSchedules) -ApplyTo SoftwareUpdatesOnly

매개 변수

-ApplyTo

만들 유지 관리 기간의 유형을 지정합니다.

  • Any: 유지 관리 기간은 모든 배포에 적용됩니다.
  • SoftwareUpdatesOnly: 유지 관리 기간은 소프트웨어 업데이트 배포에만 적용됩니다.
  • TaskSequencesOnly: 유지 관리 기간은 작업 순서 배포에만 적용됩니다.

이 매개 변수 Any 를 지정하지 않으면 가 기본값입니다.

형식:MaintenanceWindowApplyTo
허용되는 값:Any, SoftwareUpdatesOnly, TaskSequencesOnly
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ApplyToSoftwareUpdateOnly

이 매개 변수는 더 이상 사용되지 않습니다. SoftwareUpdatesOnly 값과 함께 ApplyTo 매개 변수를 사용합니다.

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

-ApplyToTaskSequenceOnly

이 매개 변수는 더 이상 사용되지 않습니다. TaskSequencesOnly 값과 함께 ApplyTo 매개 변수를 사용합니다.

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

-CollectionId

유지 관리 기간을 추가할 컬렉션의 ID를 지정합니다. 이 ID는 표준 컬렉션 ID(예 XYZ0003F: )입니다.

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

-CollectionName

유지 관리 기간을 추가할 컬렉션의 이름을 지정합니다.

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

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시하려면 이 매개 변수를 추가합니다.

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

-DisableWildcardHandling

이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과 결합할 수 없습니다.

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

-ForceWildcardHandling

이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. DisableWildcardHandling과 결합할 수 없습니다.

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

-InputObject

유지 관리 기간을 추가할 컬렉션의 개체를 지정합니다. 이 개체를 얻으려면 Get-CMCollection cmdlet을 사용합니다.

형식:IResultObject
별칭:Collection, Site
Position:0
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-IsEnabled

컬렉션에서 유지 관리 기간을 만들지만 활성 상태가 없도록 하려면 이 매개 변수를 로 $false설정합니다. 이 매개 변수를 포함하지 않으면 이 cmdlet은 유지 관리 기간을 사용하도록 설정합니다.

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

-IsUtc

UTC(협정 세계시)를 사용하도록 유지 관리 기간 일정을 구성하려면 이 매개 변수를 로 $true설정합니다. 이 매개 변수를 포함하지 않으면 일정은 현지 시간을 사용합니다.

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

-Name

유지 관리 기간의 이름을 지정합니다.

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

-Schedule

유지 관리 기간이 발생할 때 일정 개체를 지정합니다. 이 개체를 얻으려면 New-CMSchedule cmdlet을 사용합니다.

유지 관리 기간 개체는 일정을 토큰 문자열로 저장합니다. 다른 개체에서 일정을 복사하려면 Convert-CMSchedule cmdlet을 사용합니다. 예를 들면 Convert-CMSchedule -ScheduleString $mw1.ServiceWindowSchedules와 같습니다.

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

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여줍니다. cmdlet이 실행되지 않습니다.

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

입력

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

출력

IResultObject

참고

이 반환 개체 및 해당 속성에 대한 자세한 내용은 SMS_ServiceWindow 서버 WMI 클래스를 참조하세요.