Partager via

Set-CMSiteMaintenanceTask

  • Référence
Module:
ConfigurationManager

Modifier les paramètres d’une tâche de maintenance Configuration Manager.

Syntaxe

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

L’applet de commande Set-CMSiteMaintenanceTask modifie les paramètres d’une tâche de maintenance Configuration Manager. Pour plus d’informations, consultez Tâches de maintenance.

Remarque

Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1 : Définir une tâche de maintenance pour qu’elle s’exécute une fois par semaine

Cet exemple spécifie que la tâche de maintenance nommée Serveur de site SMS de sauvegarde s’exécute le vendredi chaque semaine sur le site Configuration Manager qui a le code de site CM1.

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

Exemple 2 : Configurer des destinations de sauvegarde

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

Paramètres

-BeginTime

Spécifiez la date et l’heure de début d’une tâche de maintenance.

Type:DateTime
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DaysOfWeek

Spécifiez un tableau de noms de jours qui déterminent les jours de chaque semaine sur lesquels la tâche de maintenance s’exécute.

Type:DaysOfWeek[]
Valeurs acceptées:Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DeleteOlderThanDays

Pour les tâches de maintenance qui suppriment des données anciennes, utilisez ce paramètre pour spécifier le nombre de jours.

Type:Int32
Alias:DeleteOlderThan, DeleteThanOlderDays
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DeviceName

Spécifie le nom de l’appareil sur lequel la tâche de maintenance s’exécute.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EnableAlert

Définissez ce paramètre sur $true pour activer les alertes pour les échecs de tâche, si la tâche le prend en charge.

Type:Boolean
Alias:EnabledAlert
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Enabled

Indique si la tâche de maintenance est activée dans Configuration Manager.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-FixedRun

Indique que cette applet de commande modifie la tâche de maintenance en tant qu’exécution fixe.

Type:SwitchParameter
Alias:FixedRunInterval, DisableFixedRunInterval
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InputObject

Spécifiez l’objet de tâche de maintenance à configurer. Pour obtenir cet objet, utilisez l’applet de commande Get-CMSiteMaintenanceTask .

Type:IResultObject
Alias:MaintenanceTaskObject
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-LatestBeginTime

Spécifie une date et une heure futures à laquelle la tâche de maintenance s’exécute.

Type:DateTime
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MaintenanceTask

Spécifiez le nom d’une tâche de maintenance à configurer.

Type:MaintenanceTask
Valeurs acceptées: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
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifiez le nom d’un objet de tâche de maintenance à configurer.

Type:String
Alias:MaintenanceTaskName, TaskName, ItemName
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:True

-PassThru

Renvoie un objet représentant l’élément avec lequel vous travaillez. Par défaut, cette applet de commande peut ne pas générer de sortie.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RunIntervalMins

Type:Int32
Alias:RunIntervalMinutes
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RunNow

Ajoutez ce paramètre pour que Configuration Manager exécute immédiatement la tâche de maintenance.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SiteBackupPath

S’applique à la version 2010 et ultérieure. Pour la tâche Serveur de site de sauvegarde , spécifiez la destination de sauvegarde du site. Le compte d’ordinateur du serveur de site a besoin d’un contrôle total sur le dossier de destination.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SiteCode

Spécifie le code de site du site Configuration Manager qui héberge le rôle de système de site.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SqlBackupPath

S’applique à la version 2010 et ultérieure. Pour la tâche Serveur de site de sauvegarde , spécifiez la destination de sauvegarde SQL. Le compte d’ordinateur du serveur de site a besoin d’un contrôle total sur le dossier de destination.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SummaryTask

Spécifie une tâche de maintenance récapitulative.

Type:SummaryTask
Valeurs acceptées:UpdateApplicationCatalogTables
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

IResultObject