New-SCOMMaintenanceSchedule

  • 참조
모듈:
OperationsManager

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

Syntax

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 Computer 개체 추가

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 1회만 실행합니다.

예제 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:00부터 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

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

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

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

-ActiveStartTime

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

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

-Comments

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

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

-ComputerName

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

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

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

-Confirm

cmdlet을 실행하기 전에 확인을 요청합니다.

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

-Credential

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

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

-Duration

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

Type:Int32
Aliases:DurationInMinutes
Position:6
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Enabled

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

Type:SwitchParameter
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 - 주말
Type:Int32
Position:10
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FreqRecurrenceFactor

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

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

-FreqRelativeInterval

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

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

  • 1(첫 번째)
  • 2(초)
  • 4(세 번째)
  • 8(네 번째)
  • 16(마지막)
Type:Int32
Position:12
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FreqType

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

  • 1(한 번)
  • 4(매일)
  • 8(매주)
  • 16(매월)
  • 32(매월, FreqInterval 매개 변수를 기준으로)
Type:Int32
Position:9
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-MonitoringObjects

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

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

Type:Guid[]
Position:3
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

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

-ReasonCode

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

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

  • PlannedOther
  • UnplannedOther
  • PlannedHardwareMaintenance
  • UnplannedHardwareMaintenance
  • PlannedHardwareInstallation
  • UnplannedHardwareInstallation
  • PlannedOperatingSystemReconfiguration
  • UnplannedOperatingSystemReconfiguration
  • PlannedApplicationMaintenance
  • UnplannedApplicationMaintenance
  • ApplicationInstallation
  • ApplicationUnresponsive
  • ApplicationUnstable
  • SecurityIssue
  • LossOfNetworkConnectivity
Type:MaintenanceModeReason
Accepted values:PlannedOther, UnplannedOther, PlannedHardwareMaintenance, UnplannedHardwareMaintenance, PlannedHardwareInstallation, UnplannedHardwareInstallation, PlannedOperatingSystemReconfiguration, UnplannedOperatingSystemReconfiguration, PlannedApplicationMaintenance, UnplannedApplicationMaintenance, ApplicationInstallation, ApplicationUnresponsive, ApplicationUnstable, SecurityIssue, LossOfNetworkConnectivity
Position:7
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Recursive

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

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

-SCSession

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

Type:Connection[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

cmdlet을 실행할 경우 발생하는 일을 표시합니다. cmdlet은 실행되지 않습니다.

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