다음을 통해 공유


New-SCOMMaintenanceSchedule

유지 관리 일정을 만듭니다.

구문

New-SCOMMaintenanceSchedule
   [-Name] <String>
   [-Recursive]
   [-Enabled]
   [-MonitoringObjects] <Guid[]>
   [-ActiveStartTime] <DateTime>
   [[-ActiveEndDate] <DateTime>]
   [-Duration] <Int32>
   [-ReasonCode] <MaintenanceModeReason>
   [[-Comments] <String>]
   [-FreqType] <Int32>
   [[-FreqInterval] <Int32>]
   [[-FreqRecurrenceFactor] <Int32>]
   [[-FreqRelativeInterval] <Int32>]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

New-SCOMMaintenanceSchedule cmdlet은 유지 관리 일정을 만듭니다.

리소스가 유지 관리 모드인 경우 Operations Manager는 경고, 알림, 규칙, 모니터, 자동 응답, 상태 변경 및 새 경고를 표시하지 않습니다. 유지 관리 일정을 사용하여 유지 관리 모드로 전환할 리소스 집합을 예약할 수 있습니다.

이 cmdlet을 사용하여 특정 날짜 또는 요일에 한 번, 매일, 매주 또는 매월 실행되는 일정을 만들 수 있습니다. 이 cmdlet은 만든 일정의 GUID를 반환합니다.

기본적으로 이 cmdlet은 관리 그룹에 대한 활성 영구 연결을 사용합니다. SCSession 매개 변수를 사용하여 다른 영구 연결을 지정합니다. ComputerName자격 증명 매개 변수를 사용하여 관리 그룹에 대한 임시 연결을 만들 수 있습니다. 자세한 내용은 Get-Help about_OpsMgr_Connections입력합니다.

예제

예제 1: 새 유지 관리 일정에 Windows 컴퓨터 개체 추가

PS C:\>$windowsComputer = Get-SCOMClass -DisplayName "Windows Computer" | Get-SCOMClassInstance | Where-Object { $_.DisplayName -eq 'Agent01.contoso.local' }
PS C:\>New-SCOMMaintenanceSchedule -Name 'Test Maintenance Schedule' -MonitoringObjects $windowsComputer.Id -ActiveStartTime $((Get-Date).AddMinutes(2)) -DurationInMinutes 240 -ReasonCode PlannedOther -FreqType 1 -Enabled

특정 서버에 Windows 컴퓨터 개체를 추가하는 방법을 보여 주는 예제: 240분 동안 새 유지 관리 일정에 Agent01.contoso.com 한 번만 실행합니다.

예제 2: 일일 유지 관리 일정 만들기

PS C:\>$monitoringObjects = Get-SCOMClassInstance -Name 'Agent01.contoso.local'
PS C:\># Timezone is UTC (Coordinated Universal Time)
PS C:\>$startDate = [DateTime]::SpecifyKind([DateTime]"2024-03-30T01:00:00", [System.DateTimeKind]::Utc)
PS C:\>$durationInMinutes = 90
PS C:\>
PS C:\>New-SCOMMaintenanceSchedule -Name "Daily Maintenance at 1AM" -MonitoringObjects $monitoringObjects.Id -ActiveStartTime $startDate -Duration $durationInMinutes -ReasonCode PlannedOther -FreqType 4 -FreqInterval 1 -Enabled

특정 서버 및 관련 모니터링 개체에 대한 일일 유지 관리 일정을 설정하는 방법을 보여 주는 예제: Agent01.contoso.local오전 1:00부터 90분 동안 지속됩니다.

예제 3: 주간 유지 관리 일정 만들기

PS C:\>$monitoringObjects = Get-SCOMClassInstance -Name 'Agent01.contoso.local'
PS C:\># Timezone is set to local timezone
PS C:\>$startDate = [DateTime]"2024-03-29T02:00:00"
PS C:\>$durationInMinutes = 120
PS C:\>
PS C:\>New-SCOMMaintenanceSchedule -Name "Weekly Wednesday Maintenance" -MonitoringObjects $monitoringObjects.Id -ActiveStartTime $startDate -Duration $durationInMinutes -ReasonCode PlannedOther -FreqType 8 -FreqInterval 8 -FreqRecurrenceFactor 1 -Enabled

특정 서버 및 관련 모니터링 개체에 대해 매주 수요일 주간 유지 관리 일정을 구성하는 방법을 보여 주는 예제: Agent01.contoso.local오전 2시부터 120분 동안 지속됩니다.

예제 4: 월별 유지 관리 일정 만들기

PS C:\>$monitoringObjects = Get-SCOMClassInstance -Name 'Agent01.contoso.local'
PS C:\># Timezone is set to local timezone
PS C:\>$startDate = [DateTime]"2024-04-01T03:00:00"
PS C:\>$durationInMinutes = 180
PS C:\>
PS C:\>New-SCOMMaintenanceSchedule -Name "Monthly Second Tuesday Maintenance" -MonitoringObjects $monitoringObjects.Id -ActiveStartTime $startDate -Duration $durationInMinutes -ReasonCode PlannedOther -FreqType 32 -FreqInterval 2 -FreqRelativeInterval 2 -FreqRecurrenceFactor 1 -Enabled

특정 서버 및 관련 모니터링 개체에 대해 매월 두 번째 화요일에 매월 유지 관리 일정을 설정하는 방법을 보여 주는 예제입니다. Agent01.contoso.local오전 3시부터 180분 동안 지속됩니다.

매개 변수

-ActiveEndDate

일정 실행을 중지해야 하는 종료 날짜 및 종료 시간을 지정합니다. 이 매개 변수를 지정하지 않으면 일정이 계속 실행됩니다(또는 삭제 또는 비활성화될 때까지).

예를 들어 2016년 5월 1일 오전 9:00에 종료되는 일정을 만들려면 "01-05-2016 09:00:00"을 ActiveEndDate로 지정해야 합니다. 현지 시간에 원하는 시간을 지정하는 문자열을 전달할 수 있습니다. 그러나 UTC 시간을 지정하려면 DateTimeKind가 UTC로 설정된 DateTime 개체를 지정해야 합니다.

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

-ActiveStartTime

시작 날짜와 일정이 활성화되어야 하는 시간을 지정합니다. 예를 들어 2016년 5월 1일부터 시작하여 오전 9시에 실행해야 하는 일정을 만들려면 ActiveStartTime으로 "01-05-2016 09:00:00"을 지정해야 합니다. 현지 시간에 원하는 시간을 지정하는 문자열을 전달할 수 있습니다. 그러나 UTC 시간을 지정하려면 DateTimeKind가 UTC로 설정된 DateTime 개체를 지정해야 합니다.

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

-Comments

유지 관리 일정에 대해 사람이 읽을 수 있는 주석을 지정합니다.

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

-ComputerName

컴퓨터 이름의 배열을 지정합니다. cmdlet은 이러한 컴퓨터에 대한 관리 그룹과 임시 연결을 설정합니다. NetBIOS 이름, IP 주소 또는 FQDN(정규화된 도메인 이름)을 사용할 수 있습니다. 로컬 컴퓨터를 지정하려면 컴퓨터 이름, localhost 또는 점(.)을 입력합니다.

System Center 데이터 액세스 서비스는 컴퓨터에서 활성화되어 있어야 합니다. 컴퓨터를 지정하지 않으면 cmdlet은 현재 관리 그룹 연결에 컴퓨터를 사용합니다.

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

-Confirm

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

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

-Credential

관리 그룹 연결에 대한 PSCredential 개체를 지정합니다. PSCredential 개체를 가져오려면 Get-Credential cmdlet을 사용합니다. 자세한 내용은 Get-Help Get-Credential입력합니다. ComputerName 매개 변수에 컴퓨터를 지정하는 경우 해당 컴퓨터에 액세스할 수 있는 계정을 사용합니다. 기본값은 현재 사용자입니다.

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

-Duration

유지 관리 일정의 기간을 지정합니다. 유지 관리 일정의 기간은 유지 관리 일정이 지속되는 시간입니다.

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

-Enabled

일정을 만들 때 사용하도록 설정하거나 사용하지 않도록 설정할지 여부를 나타냅니다. 이 값을 false로 설정하면 일정이 만들어지지만 사용하지 않도록 설정됩니다.

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

-FreqInterval

작업을 실행할 시기를 지정합니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

  • 1(한 번). 빈도 간격은 사용되지 않습니다.
  • 4(매일). 빈도 간격 일마다.
  • 8(매주). FreqInterval 매개 변수는 다음 중 하나 이상입니다(OR 논리 연산자와 결합).
    • 1 - 일요일
    • 2 - 월요일
    • 4 - 화요일
    • 8 - 수요일
    • 16 - 목요일
    • 32 - 금요일
    • 64 - 토요일
  • 16(매월). 해당 월의 빈도 간격 일입니다.
    • 1 - 일요일
    • 2 - 월요일
    • 3 - 화요일
    • 4 - 수요일
    • 5 - 목요일
    • 6 - 금요일
    • 7 - 토요일
  • 32(월별 상대). FreqInterval 매개 변수는 다음 값 중 하나입니다.
    • 8 - 일
    • 9 - 평일
    • 10 - 주말
형식:Int32
Position:10
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-FreqRecurrenceFactor

예약된 작업 실행 사이의 주 또는 월 수입니다. FreqRecurrenceFactorFreqType 매개 변수가 8, 16 또는 32로 설정된 경우에만 사용됩니다. FreqRecurrenceFactor 매개 변수는 기본값이 0인 정수입니다.

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

-FreqRelativeInterval

작업이 실행되는 날짜입니다. 일정이 OnceRecurrence 일정 이외의 다른 항목인 경우 필수입니다. 값은 FreqType값에 따라 달라집니다.

이 매개 변수는 다음 값 중 하나일 수 있습니다.

  • 1(첫 번째)
  • 2(초)
  • 4(세 번째)
  • 8(네 번째)
  • 16(마지막)
형식:Int32
Position:12
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-FreqType

작업을 실행할 시기를 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

  • 1(한 번)
  • 4(매일)
  • 8(매주)
  • 16(매월)
  • 32(월별, 매개 변수 FreqInterval상대적)
형식:Int32
Position:9
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-MonitoringObjects

유지 관리 모드로 전환될 모니터링 개체 GUID의 배열을 지정합니다. 생성된 일정이 유지 관리 모드로 전환할 모니터링 개체를 지정하려면 모니터링 개체의 ID 특성을 전달해야 합니다.

일정에 대해 하나 이상의 모니터링 개체를 지정할 수 있습니다. 그러나 모니터링 개체가 없으면 일정을 만들 수 없습니다.

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

-Name

이 cmdlet이 만드는 일정의 이름을 지정합니다.

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

-ReasonCode

유지 관리 기간의 이유를 지정하는 유지 관리 일정의 이유 코드를 지정합니다.

이 매개 변수에 허용되는 값은 다음과 같습니다.

  • PlannedOther
  • UnplannedOther
  • PlannedHardwareMaintenance
  • 계획되지 않은HardwareMaintenance
  • PlannedHardwareInstallation
  • 계획되지 않은HardwareInstallation
  • PlannedOperatingSystemReconfiguration
  • UnplannedOperatingSystemReconfiguration
  • PlannedApplicationMaintenance
  • UnplannedApplicationMaintenance
  • ApplicationInstallation
  • ApplicationUnresponsive
  • ApplicationUnstable
  • SecurityIssue
  • LossOfNetworkConnectivity
형식:MaintenanceModeReason
허용되는 값:PlannedOther, UnplannedOther, PlannedHardwareMaintenance, UnplannedHardwareMaintenance, PlannedHardwareInstallation, UnplannedHardwareInstallation, PlannedOperatingSystemReconfiguration, UnplannedOperatingSystemReconfiguration, PlannedApplicationMaintenance, UnplannedApplicationMaintenance, ApplicationInstallation, ApplicationUnresponsive, ApplicationUnstable, SecurityIssue, LossOfNetworkConnectivity
Position:7
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Recursive

일정이 최상위 리소스 또는 포함된 모든 리소스에 적용 가능한지 여부를 나타냅니다. 재귀 매개 변수가 false로 설정된 경우 일정이 실행될 때 지정된 리소스만 유지 관리 모드로 전환됩니다. true로 설정하면 지정된 리소스와 이 리소스와 포함 관계가 있는 모든 리소스도 유지 관리 모드로 전환됩니다.

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

-SCSession

Connection 개체의 배열을 지정합니다.

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

-WhatIf

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

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