Set-CMSiteMaintenanceTask  
更改 Configuration Manager 维护任务的设置。
语法
Set-CMSiteMaintenanceTask
   [-FixedRun]
   [-RunIntervalMins <Int32>]
   [-RunNow]
   -SummaryTask <SummaryTask>
   [-PassThru]
   [-SiteCode <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]  Set-CMSiteMaintenanceTask
   [-BeginTime <DateTime>]
   [-DaysOfWeek <DaysOfWeek[]>]
   [-DeleteOlderThanDays <Int32>]
   [-DeviceName <String>]
   [-EnableAlert <Boolean>]
   [-Enabled <Boolean>]
   -InputObject <IResultObject>
   [-LatestBeginTime <DateTime>]
   [-SiteBackupPath <String>]
   [-SqlBackupPath <String>]
   [-PassThru]
   [-SiteCode <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]  Set-CMSiteMaintenanceTask
   [-BeginTime <DateTime>]
   [-DaysOfWeek <DaysOfWeek[]>]
   [-DeleteOlderThanDays <Int32>]
   [-DeviceName <String>]
   [-EnableAlert <Boolean>]
   [-Enabled <Boolean>]
   [-LatestBeginTime <DateTime>]
   -Name <String>
   [-SiteBackupPath <String>]
   [-SqlBackupPath <String>]
   [-PassThru]
   [-SiteCode <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]  Set-CMSiteMaintenanceTask
   [-BeginTime <DateTime>]
   [-DaysOfWeek <DaysOfWeek[]>]
   [-DeleteOlderThanDays <Int32>]
   [-DeviceName <String>]
   [-EnableAlert <Boolean>]
   [-Enabled <Boolean>]
   [-LatestBeginTime <DateTime>]
   -MaintenanceTask <MaintenanceTask>
   [-SiteBackupPath <String>]
   [-SqlBackupPath <String>]
   [-PassThru]
   [-SiteCode <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]  说明
Set-CMSiteMaintenanceTask cmdlet 更改 Configuration Manager 维护任务的设置。 有关详细信息,请参阅 维护任务。
注意
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet,例如 PS XYZ:\>。 有关详细信息,请参阅 入门。
示例
示例 1:将维护任务设置为每周运行一次
此示例指定名为 “备份短信站点服务器” 的维护任务每周 五 在具有站点代码 CM1 的 Configuration Manager 站点上运行。
Set-CMSiteMaintenanceTask -SiteCode "CM1" -MaintenanceTaskName "Backup SMS Site Server" -DaysOfWeek Friday示例 2:配置备份目标
Set-CMSiteMaintenanceTask -Name $TaskName -SiteBackupPath "c:\site-backup" -SqlBackupPath "c:\sql-backup" -BeginTime (Get-Date) -DaysOfWeek Sunday,Monday -EnableAlert $true -Enabled $true参数
-BeginTime
指定维护任务的开始日期和时间。
| 类型: | DateTime | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-Confirm
提示你在运行 cmdlet 之前进行确认。
| 类型: | SwitchParameter | 
| 别名: | cf | 
| Position: | Named | 
| 默认值: | False | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-DaysOfWeek
指定一个日期名称数组,这些名称确定维护任务每周的运行日期。
| 类型: | DaysOfWeek[] | 
| 接受的值: | Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-DeleteOlderThanDays
对于删除过期数据的维护任务,请使用此参数指定天数。
| 类型: | Int32 | 
| 别名: | DeleteOlderThan, DeleteThanOlderDays | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-DeviceName
指定运行维护任务的设备的名称。
| 类型: | String | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-DisableWildcardHandling
此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。
| 类型: | SwitchParameter | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-EnableAlert
如果任务支持,请将此参数 $true 设置为 以启用任务失败警报。
| 类型: | Boolean | 
| 别名: | EnabledAlert | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-Enabled
指示是否在 Configuration Manager 中启用维护任务。
| 类型: | Boolean | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-FixedRun
指示此 cmdlet 将维护任务修改为固定运行。
| 类型: | SwitchParameter | 
| 别名: | FixedRunInterval, DisableFixedRunInterval | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-ForceWildcardHandling
此参数处理通配符,并可能导致意外行为, (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。
| 类型: | SwitchParameter | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-InputObject
指定要配置的维护任务对象。 若要获取此对象,请使用 Get-CMSiteMaintenanceTask cmdlet。
| 类型: | IResultObject | 
| 别名: | MaintenanceTaskObject | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | True | 
| 接受管道输入: | True | 
| 接受通配符: | False | 
-LatestBeginTime
指定将来运行维护任务的日期和时间。
| 类型: | DateTime | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-MaintenanceTask
指定要配置的维护任务的名称。
| 类型: | MaintenanceTask | 
| 接受的值: | BackupSiteServer, CheckApplicationTitleWithInventoryInformation, ClearUndiscoveredClients, DeleteAgedApplicationRequestData, DeleteUnusedApplicationRevisions, DeleteAgedClientOperations, DeleteAgedCollectedFiles, DeleteAgedComputerAssociationData, DeleteAgedDeleteDetectionData, DeleteAgedDeviceWipeRecord, DeleteAgedDiscoveryData, DeleteAgedEnrolledDevices, DeleteAgedEndpointProtectionHealthStatusHistoryData, DeleteAgedDevicesManagedByTheExchangeServerConnector, DeleteAgedInventoryHistory, DeleteAgedLogData, DeleteAgedSoftwareMeteringData, DeleteAgedSoftwareMeteringSummaryData, DeleteAgedClientPresenceHistory, DeleteAgedNotificationTaskHistory, DeleteAgedReplicationTrackingData, DeleteAgedReplicationSummaryData, DeleteAgedStatusMessages, DeleteAgedThreatData, DeleteAgedUnknownComputers, DeleteAgedUserDeviceAffinityData, DeleteInactiveClientDiscoveryData, DeleteObsoleteAlerts, DeleteObsoleteClientDiscoveryData, DeleteObsoleteForestDiscoverySitesAndSubnets, EvaluateProvisionedAmtComputerCertificates, MonitorKeys, RebuildIndexes, SummarizeSoftwareMeteringFileUsageData, SummarizeInstalledSoftwareData, SummarizeSoftwareMeteringMonthlyUsageData, DeleteAgedDistributionPointUsageStats, DeleteAgedProxyTrafficData | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | True | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-Name
指定要配置的维护任务对象的名称。
| 类型: | String | 
| 别名: | MaintenanceTaskName, TaskName, ItemName | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | True | 
| 接受管道输入: | False | 
| 接受通配符: | True | 
-PassThru
返回一个 对象,该对象表示正在使用的项。 默认情况下,此 cmdlet 可能不会生成任何输出。
| 类型: | SwitchParameter | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-RunIntervalMins
| 类型: | Int32 | 
| 别名: | RunIntervalMinutes | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-RunNow
添加此参数可让 Configuration Manager 立即运行维护任务。
| 类型: | SwitchParameter | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-SiteBackupPath
适用于版本 2010 及更高版本。 对于 “备份站点服务器” 任务,请指定 站点备份目标。 站点服务器计算机帐户需要对目标文件夹进行完全控制。
| 类型: | String | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-SiteCode
指定托管站点系统角色的 Configuration Manager 站点的站点代码。
| 类型: | String | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-SqlBackupPath
适用于版本 2010 及更高版本。 对于 “备份站点服务器” 任务,请指定 SQL 备份目标。 站点服务器计算机帐户需要对目标文件夹进行完全控制。
| 类型: | String | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-SummaryTask
指定摘要维护任务。
| 类型: | SummaryTask | 
| 接受的值: | UpdateApplicationCatalogTables | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | True | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-WhatIf
显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。
| 类型: | SwitchParameter | 
| 别名: | wi | 
| Position: | Named | 
| 默认值: | False | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
输入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
输出
IResultObject