Get-CMMaintenanceWindow

获取集合的维护时段。

语法

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>]

说明

使用此 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

类型:String
Position:0
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-CollectionName

指定要查询其维护时段的集合名称。

类型:String
Position:0
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-DisableWildcardHandling

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ForceWildcardHandling

此参数处理通配符,并可能导致意外行为, (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-InputObject

指定要查询其维护时段的集合对象。 若要获取此对象,请使用 Get-CMCollection cmdlet。

类型:IResultObject
别名:Collection, Site
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-MaintenanceWindowName

在目标集合上指定维护时段的名称。 默认情况下, Get-CMMaintenanceWindow 返回所有维护时段。 使用此参数将结果筛选为指定的窗口名称。

可以使用通配符:

  • *:多个字符
  • ?:单个字符
类型:String
别名:Name
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:True

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

IResultObject[]

备注

有关此返回对象及其属性的详细信息,请参阅 SMS_ServiceWindow服务器 WMI 类