Поделиться через

New-CMMaintenanceWindow

  • Ссылка
Модуль:
ConfigurationManager

Создайте период обслуживания для коллекции.

Синтаксис

New-CMMaintenanceWindow
   [-ApplyTo <MaintenanceWindowApplyTo>]
   [-ApplyToSoftwareUpdateOnly]
   [-ApplyToTaskSequenceOnly]
   [-InputObject] <IResultObject>
   [-IsEnabled <Boolean>]
   [-IsUtc <Boolean>]
   -Name <String>
   -Schedule <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMMaintenanceWindow
   [-ApplyTo <MaintenanceWindowApplyTo>]
   [-ApplyToSoftwareUpdateOnly]
   [-ApplyToTaskSequenceOnly]
   [-CollectionId] <String>
   [-IsEnabled <Boolean>]
   [-IsUtc <Boolean>]
   -Name <String>
   -Schedule <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMMaintenanceWindow
   [-ApplyTo <MaintenanceWindowApplyTo>]
   [-ApplyToSoftwareUpdateOnly]
   [-ApplyToTaskSequenceOnly]
   [-CollectionName] <String>
   [-IsEnabled <Boolean>]
   [-IsUtc <Boolean>]
   -Name <String>
   -Schedule <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Используйте этот командлет, чтобы создать период обслуживания для коллекции. Периоды обслуживания — это повторяющиеся периоды времени, в течение которых клиент Configuration Manager может выполнять задачи. Например, примените обновления программного обеспечения или установите программное обеспечение. Это окно гарантирует, что значительные системные изменения происходят только в те моменты, которые не влияют на производительность и время работы.

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

Примечание.

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

Примеры

Пример 1. Создание периода обслуживания

Первая команда использует командлет New-CMSchedule для создания объекта schedule, а затем сохраняет его в переменной $MWSchedule .

Вторая команда создает период обслуживания с именем MonthlySchedule для указанной коллекции. Период обслуживания использует расписание, хранящееся в переменной $MWSchedule .

$MWSchedule = New-CMSchedule -DayOfWeek Friday -DurationCount 1 -DurationInterval Hours -RecurCount 1 -Start "10/12/2013 21:00:00"
New-CMMaintenanceWindow -CollectionId "XYZ0005D" -Name "MonthlySchedule" -Schedule $MWSchedule

Пример 2. Копирование периода обслуживания между коллекциями

Первая команда получает период обслуживания из коллекции с идентификатором XYZ0003F. Затем создается период обслуживания для коллекции с идентификатором XYZ0005D с тем же именем, тем же расписанием и только для обновлений программного обеспечения.

$mw1 = Get-CMMaintenanceWindow -CollectionId "XYZ0003F" -MaintenanceWindowName "nightly SUM window"
New-CMMaintenanceWindow -CollectionId "XYZ0005D" -Name $mw1.Name -Schedule (Convert-CMSchedule -ScheduleString $mw1.ServiceWindowSchedules) -ApplyTo SoftwareUpdatesOnly

Параметры

-ApplyTo

Укажите тип создаваемого периода обслуживания:

  • Any: период обслуживания применяется ко всем развертываниям.
  • SoftwareUpdatesOnly: период обслуживания применяется только к развертываниям обновлений программного обеспечения.
  • TaskSequencesOnly: период обслуживания применяется только к развертываниям последовательности задач.

Если этот параметр не указан, Any используется значение по умолчанию.

Тип:MaintenanceWindowApplyTo
Допустимые значения:Any, SoftwareUpdatesOnly, TaskSequencesOnly
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ApplyToSoftwareUpdateOnly

Этот параметр не рекомендуется использовать. Используйте параметр ApplyTo со значением SoftwareUpdatesOnly .

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ApplyToTaskSequenceOnly

Этот параметр не рекомендуется использовать. Используйте параметр ApplyTo со значением TaskSequencesOnly .

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-CollectionId

Укажите идентификатор коллекции, чтобы добавить период обслуживания. Этот идентификатор является стандартным идентификатором коллекции, например XYZ0003F.

Тип:String
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-CollectionName

Укажите имя коллекции, чтобы добавить период обслуживания.

Тип:String
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Confirm

Добавьте этот параметр, чтобы запрашивать подтверждение перед выполнением командлета.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DisableWildcardHandling

Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ForceWildcardHandling

Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-InputObject

Укажите объект для коллекции, чтобы добавить период обслуживания. Чтобы получить этот объект, используйте командлет Get-CMCollection .

Тип:IResultObject
Aliases:Collection, Site
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-IsEnabled

Чтобы создать период обслуживания для коллекции, но она не активна, задайте для этого параметра значение $false. Если этот параметр не включен, этот командлет включает период обслуживания.

Тип:Boolean
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-IsUtc

Чтобы настроить расписание периода обслуживания для использования универсального скоординированного времени (UTC), задайте для этого параметра значение $true. Если этот параметр не включен, в расписании используется местное время.

Тип:Boolean
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Name

Укажите имя периода обслуживания.

Тип:String
Aliases:MaintenanceWindowName
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Schedule

Укажите объект расписания для периода обслуживания. Чтобы получить этот объект, используйте командлет New-CMSchedule .

Объект периода обслуживания сохраняет расписание в виде строки маркера. Чтобы скопировать расписание из другого объекта, используйте командлет Convert-CMSchedule . Например, Convert-CMSchedule -ScheduleString $mw1.ServiceWindowSchedules.

Тип:IResultObject
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WhatIf

Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Выходные данные

IResultObject

Примечания

Дополнительные сведения об этом возвращаемом объекте и его свойствах см . в разделе SMS_ServiceWindow класса WMI сервера.