Share via


Get-CMMaintenanceWindow

컬렉션에 대한 유지 관리 기간을 가져옵니다.

Syntax

Get-CMMaintenanceWindow
   [-InputObject] <IResultObject>
   [-MaintenanceWindowName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMMaintenanceWindow
   [-CollectionId] <String>
   [-MaintenanceWindowName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMMaintenanceWindow
   [-CollectionName] <String>
   [-MaintenanceWindowName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

이 cmdlet을 사용하여 지정된 컬렉션에 대한 유지 관리 기간을 가져옵니다. 결과를 특정 유지 관리 기간으로 필터링할 수도 있습니다.

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

참고

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

예제

예제 1: ID로 컬렉션에 대해 사용 가능한 유지 관리 기간 가져오기

이 명령은 지정된 컬렉션에 대해 사용하도록 설정된 유지 관리 기간을 가져옵니다.

Get-CMMaintenanceWindow -CollectionID "XYZ0004D" | Where-Object { $_.IsEnabled }

예제 2: 컬렉션 개체에 대한 모든 유지 관리 기간 가져오기

이 예제에서는 먼저 컬렉션 개체를 가져오고 파이프라인에 전달하여 해당 이름으로 유지 관리 기간을 가져옵니다.

$coll = Get-CMCollection -CollectionID 'XYZ0003F'
$coll | Get-CMMaintenanceWindow -MaintenanceWindowName 'nightly SUM window'

예제 3: 유지 관리 기간 일정 가져오기

이 예제에서는 먼저 특정 컬렉션에 대한 유지 관리 기간을 가져옵니다. 그런 다음 ServiceWindowSchedules 속성을 변환하여 유지 관리 기간의 일정을 표시합니다.

$mw = Get-CMMaintenanceWindow -CollectionID "XYZ000AB"
Convert-CMSchedule -ScheduleString $mw.ServiceWindowSchedules

매개 변수

-CollectionId

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

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

-CollectionName

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

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

-DisableWildcardHandling

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

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

-ForceWildcardHandling

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

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

-InputObject

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

Type:IResultObject
Aliases:Collection, Site
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-MaintenanceWindowName

대상 컬렉션에서 유지 관리 기간의 이름을 지정합니다. 기본적으로 Get-CMMaintenanceWindow는 모든 유지 관리 기간을 반환합니다. 이 매개 변수를 사용하여 결과를 지정된 창 이름으로 필터링합니다.

와일드카드 문자를 사용할 수 있습니다.

  • *: 여러 문자
  • ?: 단일 문자
Type:String
Aliases:Name
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

입력

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

출력

IResultObject[]

참고

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