Get-CMMaintenanceWindow

  • 参考
模块:
ConfigurationManager

获取集合的维护时段。

语法

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。

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 类。