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

Set-CMMaintenanceWindow

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

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

Синтаксис

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

Описание

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

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

Примечание.

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

Примеры

Пример 1. Изменение периода обслуживания для применения только к развертываниям последовательности задач

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

Set-CMMaintenanceWindow -Name "DiskCleanup" -CollectionID "XYZ0004D" -ApplyTo TaskSequencesOnly

Параметры

-ApplyTo

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

  • Any: период обслуживания применяется ко всем развертываниям.
  • SoftwareUpdatesOnly: период обслуживания применяется только к развертываниям обновлений программного обеспечения.
  • TaskSequencesOnly: период обслуживания применяется только к развертываниям последовательности задач.
Тип: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:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-CollectionName

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

Тип:String
Position:Named
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:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-IsEnabled

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

  • $true: включите период обслуживания. Развертывания выполняются только по расписанию окна.
  • $false: отключите период обслуживания. Развертывания выполняются в любое время, как настроено.
Тип:Boolean
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-IsUtc

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

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

-MaintenanceWindow

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

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

-MaintenanceWindowName

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

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

-PassThru

Добавьте этот параметр, чтобы вернуть объект, представляющий элемент, с которым вы работаете. По умолчанию этот командлет не может создавать выходные данные.

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

-Schedule

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

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

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

-WhatIf

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

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

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

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

System.Object