Compartilhar via

Set-CMSiteMaintenanceTask

  • Referência
Módulo:
ConfigurationManager

Alterar as definições de uma tarefa de manutenção do Configuration Manager.

Sintaxe

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 definições de uma tarefa de manutenção do Configuration Manager. Para obter mais informações, veja Tarefas de manutenção.

Observação

Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.

Exemplos

Exemplo 1: Definir uma tarefa de manutenção para ser executada uma vez por semana

Este exemplo especifica que a tarefa de manutenção denominada Backup SMS Site Server é executada na sexta-feira todas as semanas no site do Configuration Manager que tem o código do site CM1.

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

Exemplo 2: Configurar destinos de cópia de segurança

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 hora em que é iniciada uma tarefa de manutenção.

Tipo:DateTime
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DaysOfWeek

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

Tipo:DaysOfWeek[]
Valores aceitos:Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DeleteOlderThanDays

Para tarefas de manutenção que eliminam dados desatuais, utilize este parâmetro para especificar o número de dias.

Tipo:Int32
Aliases:DeleteOlderThan, DeleteThanOlderDays
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DeviceName

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EnableAlert

Defina este parâmetro como para $true ativar alertas para falhas de tarefas, se a tarefa o suportar.

Tipo:Boolean
Aliases:EnabledAlert
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Enabled

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

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-FixedRun

Indica que este cmdlet modifica a tarefa de manutenção como uma execução fixa.

Tipo:SwitchParameter
Aliases:FixedRunInterval, DisableFixedRunInterval
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Especifique o objeto de tarefa de manutenção a configurar. Para obter este objeto, utilize o cmdlet Get-CMSiteMaintenanceTask .

Tipo:IResultObject
Aliases:MaintenanceTaskObject
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-LatestBeginTime

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

Tipo:DateTime
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MaintenanceTask

Especifique o nome de uma tarefa de manutenção a configurar.

Tipo:MaintenanceTask
Valores aceitos: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
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

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

Tipo:String
Aliases:MaintenanceTaskName, TaskName, ItemName
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:True

-PassThru

Devolve um objeto que representa o item com o qual está a trabalhar. Por predefinição, este cmdlet pode não gerar qualquer saída.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RunIntervalMins

Tipo:Int32
Aliases:RunIntervalMinutes
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RunNow

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SiteBackupPath

Aplica-se à versão 2010 e posterior. Para a tarefa Cópia de Segurança do Servidor do Site , especifique o destino da cópia de segurança do site. A conta de computador do servidor do site precisa de controlo total para a pasta de destino.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SiteCode

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SqlBackupPath

Aplica-se à versão 2010 e posterior. Para a tarefa Cópia de Segurança do Servidor do Site , especifique o destino da cópia de segurança do SQL. A conta de computador do servidor do site precisa de controlo total para a pasta de destino.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SummaryTask

Especifica uma tarefa de manutenção de resumo.

Tipo:SummaryTask
Valores aceitos:UpdateApplicationCatalogTables
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

IResultObject