Share via


Set-CMSoftwareUpdatePointComponent

Configurez le composant de site pour le point de mise à jour logicielle.

Syntax

Set-CMSoftwareUpdatePointComponent
   [-AddCompany <String[]>]
   [-AddLanguageSummaryDetail <String[]>]
   [-AddLanguageUpdateFile <String[]>]
   [-AddProduct <String[]>]
   [-AddProductFamily <String[]>]
   [-AddUpdateClassification <String[]>]
   [-ContentFileOption <ContentFileOptions>]
   [-DefaultWsusServer <String>]
   [-EnableCallWsusCleanupWizard <Boolean>]
   [-EnableManualCertManagement <Boolean>]
   [-EnableSyncFailureAlert <Boolean>]
   [-EnableThirdPartyUpdates <Boolean>]
   [-FeatureUpdateMaxRuntimeMins <Int32>]
   [-ImmediatelyExpireSupersedence <Boolean>]
   [-ImmediatelyExpireSupersedenceForFeature <Boolean>]
   [-NonFeatureUpdateMaxRuntimeMins <Int32>]
   [-PassThru]
   [-RemoveCompany <String[]>]
   [-RemoveLanguageSummaryDetail <String[]>]
   [-RemoveLanguageUpdateFile <String[]>]
   [-RemoveProduct <String[]>]
   [-RemoveProductFamily <String[]>]
   [-RemoveUpdateClassification <String[]>]
   [-ReportingEvent <ReportingEventType>]
   [-Schedule <IResultObject>]
   [-SiteCode <String>]
   [-SynchronizeAction <SynchronizeActionType>]
   [-UpstreamSourceLocation <String>]
   [-WaitMonth <Int32>]
   [-WaitMonthForFeature <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMSoftwareUpdatePointComponent
   [-AddCompany <String[]>]
   [-AddLanguageSummaryDetail <String[]>]
   [-AddLanguageUpdateFile <String[]>]
   [-AddProduct <String[]>]
   [-AddProductFamily <String[]>]
   [-AddUpdateClassification <String[]>]
   [-ContentFileOption <ContentFileOptions>]
   [-DefaultWsusServer <String>]
   [-EnableCallWsusCleanupWizard <Boolean>]
   [-EnableManualCertManagement <Boolean>]
   [-EnableSyncFailureAlert <Boolean>]
   [-EnableThirdPartyUpdates <Boolean>]
   [-FeatureUpdateMaxRuntimeMins <Int32>]
   [-ImmediatelyExpireSupersedence <Boolean>]
   [-ImmediatelyExpireSupersedenceForFeature <Boolean>]
   -Name <String>
   [-NonFeatureUpdateMaxRuntimeMins <Int32>]
   [-PassThru]
   [-RemoveCompany <String[]>]
   [-RemoveLanguageSummaryDetail <String[]>]
   [-RemoveLanguageUpdateFile <String[]>]
   [-RemoveProduct <String[]>]
   [-RemoveProductFamily <String[]>]
   [-RemoveUpdateClassification <String[]>]
   [-ReportingEvent <ReportingEventType>]
   [-Schedule <IResultObject>]
   [-SynchronizeAction <SynchronizeActionType>]
   [-UpstreamSourceLocation <String>]
   [-WaitMonth <Int32>]
   [-WaitMonthForFeature <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMSoftwareUpdatePointComponent
   [-AddCompany <String[]>]
   [-AddLanguageSummaryDetail <String[]>]
   [-AddLanguageUpdateFile <String[]>]
   [-AddProduct <String[]>]
   [-AddProductFamily <String[]>]
   [-AddUpdateClassification <String[]>]
   [-ContentFileOption <ContentFileOptions>]
   [-DefaultWsusServer <String>]
   [-EnableCallWsusCleanupWizard <Boolean>]
   [-EnableManualCertManagement <Boolean>]
   [-EnableSyncFailureAlert <Boolean>]
   [-EnableThirdPartyUpdates <Boolean>]
   [-FeatureUpdateMaxRuntimeMins <Int32>]
   [-ImmediatelyExpireSupersedence <Boolean>]
   [-ImmediatelyExpireSupersedenceForFeature <Boolean>]
   -InputObject <IResultObject>
   [-NonFeatureUpdateMaxRuntimeMins <Int32>]
   [-PassThru]
   [-RemoveCompany <String[]>]
   [-RemoveLanguageSummaryDetail <String[]>]
   [-RemoveLanguageUpdateFile <String[]>]
   [-RemoveProduct <String[]>]
   [-RemoveProductFamily <String[]>]
   [-RemoveUpdateClassification <String[]>]
   [-ReportingEvent <ReportingEventType>]
   [-Schedule <IResultObject>]
   [-SynchronizeAction <SynchronizeActionType>]
   [-UpstreamSourceLocation <String>]
   [-WaitMonth <Int32>]
   [-WaitMonthForFeature <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Utilisez cette applet de commande pour configurer le composant de site pour le point de mise à jour logicielle. Utilisez-la après avoir ajouté un point de mise à jour logicielle, par exemple avec l’applet de commande Add-CMSoftwareUpdatePoint . Vous pouvez également utiliser cette applet de commande pour reconfigurer un point de mise à jour logicielle existant.

Un composant de point de mise à jour logicielle interagit avec un serveur Windows Server Update Services (WSUS) pour configurer les paramètres de mise à jour, demander la synchronisation à la source de mise à jour en amont et synchroniser les mises à jour de la base de données WSUS avec la base de données du serveur de site sur le site central.

Pour plus d’informations, consultez Composants de site pour Configuration Manager.

Remarque

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

Exemples

Exemple 1 : Modifier un composant de site de point de mise à jour logicielle

La première commande obtient un objet composant de point de mise à jour logicielle à partir du site XYZ . La commande stocke l’objet dans la variable $supComp .

La deuxième commande crée un objet de planification qui se répète tous les trois jours.

Cet exemple place ensuite les paramètres de l’applet de commande dans la variable de paramètres . Il n’est pas nécessaire de plaquer les paramètres. Cela facilite simplement la lecture des paramètres pour une ligne de commande aussi longue.

La dernière commande modifie les propriétés courantes du composant point de mise à jour logicielle.

$supComp = Get-CMSoftwareUpdatePointComponent -SiteSystemServerName 'sup1.contoso.com' -SiteCode 'XYZ'

$schedule = New-CMSchedule -RecurCount 3 -RecurInterval Days -Start "2020/1/7 12:00:00"

$addLang = "Dutch"
$removeLang = "English"

$parameters = @{
  InputObject = $supComp
  DefaultWsusServer = 'sup.contoso.com'
  SynchronizeAction = 'SynchronizeFromMicrosoftUpdate'
  ReportingEvent = 'CreateAllWsusReportingEvents'
  RemoveUpdateClassification = "Update Rollups"
  AddUpdateClassification = "Critical Updates"
  Schedule = $schedule
  EnableSyncFailureAlert = $true
  ImmediatelyExpireSupersedence = $true
  AddLanguageUpdateFile = $addLang
  AddLanguageSummaryDetails = $addLang
  RemoveLanguageUpdateFile = $removeLang
  RemoveLanguageSummaryDetails = $removeLang
}

Set-CMSoftwareUpdatePointComponent @parameters

Exemple 2 : Désactiver la synchronisation des points de mise à jour logicielle

La commande suivante supprime la planification du composant de site, ce qui désactive la synchronisation.

Set-CMSoftwareUpdatePointComponent -Name "Contoso-SiteSysSrv.Western.Contoso.com" -Schedule $null

Paramètres

-AddCompany

Ce paramètre est un tableau de chaînes de noms de société. Utilisez cette option pour synchroniser la liste des produits de l’ensemble de l’entreprise.

Pour supprimer une entreprise entière de cette liste, utilisez le paramètre RemoveCompany .

Pour plus d’informations, consultez Configurer des classifications et des produits à synchroniser.

Type:String[]
Aliases:AddCompanies
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AddLanguageSummaryDetail

Ce paramètre est un tableau de chaînes de noms de langage. Utilisez cette option pour télécharger les détails du résumé pour les langues spécifiées.

Pour supprimer des langues de cette liste, utilisez le paramètre RemoveLanguageSummaryDetail .

Pour plus d’informations, consultez Planifier les paramètres de synchronisation - Langues.

Type:String[]
Aliases:AddLanguageSummaryDetails
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AddLanguageUpdateFile

Ce paramètre est un tableau de chaînes de noms de langage. Utilisez cette option pour télécharger le fichier de mise à jour logicielle pour les langues spécifiées.

Pour supprimer des langues de cette liste, utilisez le paramètre RemoveLanguageUpdateFile .

Pour plus d’informations, consultez Planifier les paramètres de synchronisation - Langues.

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

-AddProduct

Ce paramètre est un tableau de chaînes de noms de produits. Utilisez cette option pour synchroniser les produits.

Pour supprimer un produit de cette liste, utilisez le paramètre RemoveProduct .

Pour plus d’informations, consultez Configurer des classifications et des produits à synchroniser.

Type:String[]
Aliases:AddProducts
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AddProductFamily

Ce paramètre est un tableau de chaînes de noms de famille de produits. Utilisez cette option pour synchroniser la liste des produits d’une famille de produits.

Pour supprimer une famille de produits entière de cette liste, utilisez le paramètre RemoveProductFamily .

Pour plus d’informations, consultez Configurer des classifications et des produits à synchroniser.

Type:String[]
Aliases:AddProductFamilies
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AddUpdateClassification

Ce paramètre est un tableau de chaînes de classifications de mise à jour. Utilisez cette option pour synchroniser des classifications de mises à jour logicielles spécifiques.

Pour supprimer une classification de cette liste, utilisez le paramètre RemoveUpdateClassification .

Pour plus d’informations, consultez Configurer des classifications et des produits à synchroniser.

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

-Confirm

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

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

-ContentFileOption

Utilisez ce paramètre pour configurer la façon dont le point de mise à jour logicielle télécharge les fichiers de mise à jour. Les fichiers d’installation rapide offrent un téléchargement plus réduit et une installation plus rapide sur les ordinateurs, car seuls les fichiers nécessaires sont téléchargés et installés. Il s’agit de fichiers plus volumineux et augmenteront les temps de téléchargement de vos serveurs de site et points de distribution.

  • FullFilesOnly: Télécharger les fichiers complets pour toutes les mises à jour approuvées
  • ExpressForWindows10Only: téléchargez les fichiers complets pour toutes les mises à jour approuvées et les fichiers d’installation rapide pour Windows 10 ou une version ultérieure
Type:ContentFileOptions
Accepted values:FullFilesOnly, ExpressForWindows10Only
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultWsusServer

Spécifiez le nom de domaine complet du serveur WSUS.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableCallWsusCleanupWizard

Définissez ce paramètre sur $true pour permettre aux tâches de nettoyage WSUS de s’exécuter après la synchronisation. Pour plus d’informations, consultez Maintenance des mises à jour logicielles.

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

-EnableManualCertManagement

Définissez ce paramètre sur $true pour gérer manuellement le certificat de signature WSUS pour les mises à jour tierces. Ce paramètre dépend du paramètre EnableThirdPartyUpdates .

Pour plus d’informations, consultez Activer les mises à jour tierces.

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

-EnableSyncFailureAlert

Définissez ce paramètre sur $true pour permettre au composant de créer une alerte en cas d’échec de la synchronisation.

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

-EnableThirdPartyUpdates

Définissez ce paramètre sur $trueActiver les mises à jour logicielles tierces. Vous pouvez également utiliser le paramètre EnableManualCertManagement .

Pour plus d’informations, consultez Activer les mises à jour tierces.

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

-FeatureUpdateMaxRuntimeMins

Spécifiez une valeur entière pour la durée maximale par défaut de l’installation d’une mise à jour logicielle. Vous pouvez remplacer cette valeur par défaut pour une mise à jour spécifique. Ce paramètre affecte uniquement les mises à jour nouvellement synchronisées. Ce paramètre s’applique uniquement aux mises à jour des fonctionnalités Windows.

Pour configurer la durée d’exécution maximale des mises à jour Office 365 et des mises à jour non liées aux fonctionnalités pour Windows, utilisez le paramètre NonFeatureUpdateMaxRuntimeMins.

Pour plus d’informations, consultez Planifier les paramètres de synchronisation.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ImmediatelyExpireSupersedence

Définissez ce paramètre sur $true pour faire expirer immédiatement une mise à jour logicielle lorsqu’une autre mise à jour la remplace ou après une période spécifiée.

Si vous spécifiez la valeur $False pour ce paramètre, spécifiez le nombre de mois d’attente d’expiration à l’aide du paramètre WaitMonth .

Certaines mises à jour n’expirent jamais, par exemple les mises à jour de définition.

Si vous modifiez ce paramètre, le site démarre une synchronisation complète.

Pour configurer ce comportement pour les mises à jour des fonctionnalités Windows, utilisez le paramètre ImmediatelyExpireSupersedenceForFeature .

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

-ImmediatelyExpireSupersedenceForFeature

Définissez ce paramètre sur $true pour faire expirer immédiatement une mise à jour des fonctionnalités Windows lorsqu’une autre mise à jour la remplace ou après une période spécifiée.

Si vous spécifiez la valeur $False pour ce paramètre, spécifiez le nombre de mois d’attente d’expiration à l’aide du paramètre WaitMonthForFeature .

Si vous modifiez ce paramètre, le site démarre une synchronisation complète.

Pour configurer ce comportement pour les mises à jour non liées aux fonctionnalités, utilisez le paramètre ImmediatelyExpireSupersedence .

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

-InputObject

Spécifiez un objet de composant de site de point de mise à jour logicielle à configurer. Pour obtenir cet objet, utilisez l’applet de commande Get-CMSoftwareUpdatePointComponent .

Type:IResultObject
Aliases:Site, SiteComponent
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Spécifiez le nom d’un serveur de système de site avec le rôle de point de mise à jour logicielle.

Type:String
Aliases:SiteName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-NonFeatureUpdateMaxRuntimeMins

Spécifiez une valeur entière pour la durée maximale par défaut de l’installation d’une mise à jour logicielle. Vous pouvez remplacer cette valeur par défaut pour une mise à jour spécifique. Ce paramètre affecte uniquement les mises à jour nouvellement synchronisées. Ce paramètre s’applique uniquement aux mises à jour Office 365 et aux mises à jour non liées aux fonctionnalités pour Windows.

Pour configurer la durée d’exécution maximale des mises à jour des fonctionnalités Windows, utilisez le paramètre FeatureUpdateMaxRuntimeMins .

Pour plus d’informations, consultez Planifier les paramètres de synchronisation.

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

-PassThru

Ajoutez ce paramètre pour renvoyer un objet qui représente 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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemoveCompany

Ce paramètre est un tableau de chaînes de noms de société. Utilisez cette option pour ne pas synchroniser la liste des produits de l’entreprise entière.

Pour ajouter une société entière à cette liste, utilisez le paramètre AddCompany .

Pour plus d’informations, consultez Configurer des classifications et des produits à synchroniser.

Type:String[]
Aliases:RemoveCompanies
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemoveLanguageSummaryDetail

Ce paramètre est un tableau de chaînes de noms de langage. Utilisez cette option pour ne pas télécharger les détails du résumé pour les langues spécifiées.

Pour ajouter des langues à cette liste, utilisez le paramètre AddLanguageSummaryDetail .

Pour plus d’informations, consultez Planifier les paramètres de synchronisation - Langues.

Type:String[]
Aliases:RemoveLanguageSummaryDetails
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemoveLanguageUpdateFile

Ce paramètre est un tableau de chaînes de noms de langage. Utilisez cette option pour ne pas télécharger le fichier de mise à jour logicielle pour les langues spécifiées.

Pour ajouter des langues à cette liste, utilisez le paramètre AddLanguageUpdateFile .

Pour plus d’informations, consultez Planifier les paramètres de synchronisation - Langues.

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

-RemoveProduct

Ce paramètre est un tableau de chaînes de noms de produits. Utilisez cette option pour ne pas synchroniser les produits.

Pour ajouter un produit à cette liste, utilisez le paramètre AddProduct .

Pour plus d’informations, consultez Configurer des classifications et des produits à synchroniser.

Type:String[]
Aliases:RemoveProducts
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemoveProductFamily

Ce paramètre est un tableau de chaînes de noms de famille de produits. Utilisez cette option pour ne pas synchroniser la liste des produits d’une famille de produits.

Pour ajouter une famille de produits entière à cette liste, utilisez le paramètre AddProductFamily .

Pour plus d’informations, consultez Configurer des classifications et des produits à synchroniser.

Type:String[]
Aliases:RemoveProductFamilies
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemoveUpdateClassification

Ce paramètre est un tableau de chaînes de classifications de mise à jour. Utilisez cette option pour ne pas synchroniser des classifications de mises à jour logicielles spécifiques.

Pour ajouter une classification à cette liste, utilisez le paramètre AddUpdateClassification .

Pour plus d’informations, consultez Configurer des classifications et des produits à synchroniser.

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

-ReportingEvent

Spécifiez si l’agent Windows Update (WUA) sur les clients crée des messages d’événement pour la création de rapports WSUS. Configuration Manager n’utilise pas ces événements. Ne créez pas ces événements, sauf si vous en avez besoin pour d’autres utilisations.

Type:ReportingEventType
Accepted values:DoNotCreateWsusReportingEvents, CreateOnlyWsusStatusReportingEvents, CreateAllWsusReportingEvents
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Schedule

Spécifiez un objet Schedule pour activer la synchronisation. Pour désactiver la synchronisation, définissez ce paramètre sur $null.

Pour obtenir un objet de planification, utilisez l’applet de commande New-CMSchedule .

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

-SiteCode

Spécifiez le code à trois caractères du site sur lequel configurer son composant de point de mise à jour logicielle.

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

-SynchronizeAction

Spécifiez la source de synchronisation pour ce point de mise à jour logicielle.

Si vous sélectionnez la valeur , spécifiez l’emplacement de la source de SynchronizeFromAnUpstreamDataSourceLocationdonnées à l’aide du paramètre UpstreamSourceLocation .

Pour plus d’informations, consultez Planifier les paramètres de synchronisation.

Type:SynchronizeActionType
Accepted values:SynchronizeFromMicrosoftUpdate, SynchronizeFromAnUpstreamDataSourceLocation, DoNotSynchronizeFromMicrosoftUpdateOrUpstreamDataSource
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UpstreamSourceLocation

Spécifiez un emplacement de données en amont en tant qu’URL. Par exemple, https://wsusserver.contoso.com:8531

Pour utiliser cet emplacement, spécifiez SynchronizeFromAnUpstreamDataSourceLocation pour le paramètre SynchronizeAction .

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

-WaitMonth

Définissez la valeur entière du nombre de mois à attendre avant l’expiration d’une mise à jour logicielle après qu’une autre mise à jour la remplace.

Ce paramètre dépend du paramètre ImmediatelyExpireSupersedence .

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

-WaitMonthForFeature

Définissez la valeur entière pour le nombre de mois à attendre avant l’expiration d’une mise à jour des fonctionnalités Windows après qu’une autre mise à jour la remplace.

Ce paramètre dépend du paramètre ImmediatelyExpireSupersedenceForFeature .

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

IResultObject

Notes

Pour plus d’informations sur cet objet de retour et ses propriétés, consultez SMS_SCI_Component classe WMI du serveur.