Share via

Set-CMSiteMaintenanceTask

  • Referência
Módulo:
ConfigurationManager

Alterar configurações para uma tarefa de manutenção do Configuration Manager.

Syntax

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

Description

O cmdlet Set-CMSiteMaintenanceTask altera as configurações de uma tarefa de manutenção do Configuration Manager. Para obter mais informações, consulte Tarefas de manutenção.

Observação

Execute cmdlets do Configuration Manager na unidade de site do Configuration Manager, por PS XYZ:\> exemplo. Para obter mais informações, consulte getting started.

Exemplos

Exemplo 1: definir uma tarefa de manutenção para ser executado uma vez por semana

Este exemplo especifica que a tarefa de manutenção denominada Backup SMS Site Server é executado na sexta-feira de cada semana no site do Gerenciador de Configurações que tem o código do site CM1. ****

Set-CMSiteMaintenanceTask -SiteCode "CM1" -MaintenanceTaskName "Backup SMS Site Server" -DaysOfWeek Friday

Exemplo 2: Configurar destinos de backup

Set-CMSiteMaintenanceTask -Name $TaskName -SiteBackupPath "c:\site-backup" -SqlBackupPath "c:\sql-backup" -BeginTime (Get-Date) -DaysOfWeek Sunday,Monday -EnableAlert $true -Enabled $true

Parâmetros

-BeginTime

Especifique a data e a hora em que uma tarefa de manutenção será iniciada.

Type:DateTime
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-DaysOfWeek

Especifique uma matriz de nomes de dia que determinam os dias de cada semana em que a tarefa de manutenção é executado.

Type:DaysOfWeek[]
Accepted values:Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DeleteOlderThanDays

Para tarefas de manutenção que excluem dados de idade, use este parâmetro para especificar o número de dias.

Type:Int32
Aliases:DeleteOlderThan, DeleteThanOlderDays
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DeviceName

Especifica o nome do dispositivo no qual a tarefa de manutenção é executado.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-EnableAlert

De definir esse parâmetro $true para habilitar alertas para falhas de tarefas, se a tarefa for compatível com ele.

Type:Boolean
Aliases:EnabledAlert
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-FixedRun

Indica que esse cmdlet modifica a tarefa de manutenção como uma corrida fixa.

Type:SwitchParameter
Aliases:FixedRunInterval, DisableFixedRunInterval
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Habilitado

Indica se a tarefa de manutenção está habilitada no Configuration Manager.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Especifique o objeto de tarefa de manutenção a ser configurada. Para obter esse objeto, use o cmdlet Get-CMSiteMaintenanceTask.

Type:IResultObject
Aliases:MaintenanceTaskObject
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-LatestBeginTime

Especifica uma data e hora futuras em que a tarefa de manutenção é executado.

Type:DateTime
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-MaintenanceTask

Especifique o nome de uma tarefa de manutenção a ser configurada.

Type:MaintenanceTask
Accepted values: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
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifique o nome de um objeto de tarefa de manutenção a ser configurada.

Type:String
Aliases:MaintenanceTaskName, TaskName, ItemName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

-PassThru

Retorna um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet pode não gerar nenhuma saída.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RunIntervalMins

Type:Int32
Aliases:RunIntervalMinutes
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RunNow

Adicione esse parâmetro para que o Configuration Manager execute a tarefa de manutenção imediatamente.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SiteBackupPath

Aplica-se à versão 2010 e posterior. Para a tarefa Servidor de Site de Backup, especifique o destino de backup do site. A conta do computador do servidor de sites precisa de controle total para a pasta de destino.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SiteCode

Especifica o código do site do site do Configuration Manager que hospeda a função do sistema de sites.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SqlBackupPath

Aplica-se à versão 2010 e posterior. Para a tarefa Servidor de Site de Backup, especifique o SQL de backup. A conta do computador do servidor de sites precisa de controle total para a pasta de destino.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SummaryTask

Especifica uma tarefa de manutenção resumida.

Type:SummaryTask
Accepted values:UpdateApplicationCatalogTables
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

IResultObject