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 - 토요일
- 1 - 일요일
- 16(매월). 해당 월의 빈도 간격 일입니다.
- 1 - 일요일
- 2 - 월요일
- 3 - 화요일
- 4 - 수요일
- 5 - 목요일
- 6 - 금요일
- 7 - 토요일
- 1 - 일요일
- 32(월별 상대).
FreqInterval 매개 변수는 다음 값 중 하나입니다.
- 8 - 일
- 9 - 평일
- 10 - 주말
- 8 - 일
형식: | 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 |