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

Описание

Используйте этот командлет для получения периодов обслуживания для указанной коллекции. Вы также можете отфильтровать результаты по определенному периоду обслуживания.

Дополнительные сведения о периодах обслуживания см. в статье Использование периодов обслуживания в Configuration Manager.

Примечание.

Выполните командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>. Дополнительные сведения см. в статье Начало работы.

Примеры

Пример 1. Получение включенных периодов обслуживания для коллекции по идентификатору

Эта команда возвращает периоды обслуживания, которые включены для указанной коллекции.

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

Укажите идентификатор коллекции для запроса периодов обслуживания. Этот идентификатор является стандартным идентификатором коллекции, например 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 .

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 сервера.