Partager via


Get-CMSoftwareUpdate

Obtenir une mise à jour logicielle.

Syntaxe

Get-CMSoftwareUpdate
   [-ArticleId <String>]
   [-BulletinId <String>]
   [-Category <IResultObject[]>]
   [-CategoryName <String[]>]
   [-DatePostedMax <DateTime>]
   [-DatePostedMin <DateTime>]
   [-DateRevisedMax <DateTime>]
   [-DateRevisedMin <DateTime>]
   [-EulaExist <Boolean>]
   [-Fast]
   [-IncludeUpgrade]
   [-IsContentProvisioned <Boolean>]
   [-IsDeployed <Boolean>]
   [-IsExpired <Boolean>]
   [-IsLatest <Boolean>]
   [-IsOfflineServiceable <Boolean>]
   [-IsSuperseded <Boolean>]
   [-IsUserDefined <Boolean>]
   [-Name <String>]
   [-OnlyExpired]
   [-Severity <CustomSeverityType>]
   [-Vendor <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMSoftwareUpdate
   [-Fast]
   -Id <Int32>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMSoftwareUpdate
   [-Fast]
   -UpdateGroup <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMSoftwareUpdate
   [-Fast]
   -UpdateGroupId <String[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMSoftwareUpdate
   [-Fast]
   -UpdateGroupName <String[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Utilisez cette applet de commande pour obtenir une ou plusieurs mises à jour logicielles.

Pour plus d’informations, consultez la documentation relative à la gestion des mises à jour logicielles dans la documentation principale.

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 : Obtenir les mises à jour logicielles téléchargées

Cette commande obtient toutes les mises à jour logicielles que le site a téléchargées.

Get-CMSoftwareUpdate -IsContentProvisioned $True

Exemple 2 : Obtenir des mises à jour logicielles par groupe de mises à jour

Cette commande obtient d’abord l’objet de groupe de mises à jour logicielles nommé TestSUgroup10. Il utilise ensuite l’opérateur de pipeline pour passer l’objet à Get-CMSoftwareUpdate. Le résultat est la liste de toutes les mises à jour logicielles pour le groupe de mises à jour logicielles.

Get-CMSoftwareUpdateGroup -Name "TestSUgroup10" | Get-CMSoftwareUpdate

Paramètres

-ArticleId

Spécifiez l’ID d’article d’une mise à jour logicielle. Par exemple : 4571687.

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:True

-BulletinId

Spécifiez l’ID de bulletin d’une mise à jour logicielle. Par exemple : MS18-952.

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:True

-Category

Spécifiez la catégorie d’une mise à jour logicielle. Pour obtenir un objet de catégorie, utilisez l’applet de commande Get-CMSoftwareUpdateCategory .

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

-CategoryName

Spécifiez un tableau de noms de catégorie pour les mises à jour logicielles.

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

-DatePostedMax

Spécifiez la dernière date de publication d’une mise à jour logicielle.

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

-DatePostedMin

Spécifiez la date la plus ancienne à laquelle une mise à jour logicielle a été publiée.

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

-DateRevisedMax

Spécifiez la dernière date à laquelle une mise à jour logicielle a été révisée.

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

-DateRevisedMin

Spécifiez la date la plus ancienne à laquelle une mise à jour logicielle a été révisée.

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

-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

-EulaExist

Définissez ce paramètre sur $true pour filtrer les résultats de toutes les mises à jour qui ont un contrat de licence.

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

-Fast

Ajoutez ce paramètre pour ne pas actualiser automatiquement les propriétés différées. Les propriétés différées contiennent des valeurs qui sont relativement inefficaces à récupérer. L’obtention de ces propriétés peut entraîner un trafic réseau supplémentaire et diminuer les performances des applets de commande.

Si vous n’utilisez pas ce paramètre, l’applet de commande affiche un avertissement. Pour désactiver cet avertissement, définissez $CMPSSuppressFastNotUsedCheck = $true.

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

-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

-Id

Spécifie l’ID d’une mise à jour logicielle. Cette valeur est la CI_ID, par exemple 143404.

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

-IncludeUpgrade

Ajoutez ce paramètre pour inclure les mises à jour logicielles dans la catégorie mise à niveau.

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

-IsContentProvisioned

Définissez ce paramètre sur $true pour filtrer les résultats de toutes les mises à jour pour lesquelles le site a téléchargé du contenu.

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

-IsDeployed

Définissez ce paramètre sur $true pour filtrer les résultats de toutes les mises à jour déployées.

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

-IsExpired

Définissez ce paramètre sur $true pour filtrer les résultats de toutes les mises à jour qui ont expiré.

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

-IsLatest

Définissez ce paramètre sur $true pour filtrer les résultats de la dernière version de la mise à jour logicielle.

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

-IsOfflineServiceable

Définissez ce paramètre sur $true pour filtrer les résultats de toutes les mises à jour qui peuvent être mises à jour hors connexion. Vous pouvez utiliser l’outil en ligne de commande DISM pour injecter ces mises à jour dans une image de système d’exploitation.

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

-IsSuperseded

Définissez ce paramètre sur $true pour filtrer les résultats de toutes les mises à jour remplacées.

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

-IsUserDefined

Définissez ce paramètre sur $true pour filtrer les résultats de toutes les mises à jour définies par l’utilisateur.

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

-Name

Spécifiez le nom d’une mise à jour logicielle. Ce paramètre est comparé à l’attribut de nom d’affichage localisé.

Vous pouvez utiliser des caractères génériques :

  • *: plusieurs caractères
  • ?: caractère unique
Type:String
Alias:LocalizedDisplayName
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:True

-OnlyExpired

Ajoutez ce paramètre pour rechercher uniquement les mises à jour logicielles expirées.

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

-Severity

Spécifiez la gravité de la mise à jour logicielle.

Type:CustomSeverityType
Valeurs acceptées:None, Low, Moderate, Important, Critical
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-UpdateGroup

Spécifiez l’objet de groupe de mises à jour logicielles. Pour obtenir cet objet, utilisez l’applet de commande Get-CMSoftwareUpdateGroup .

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

-UpdateGroupId

Spécifiez un tableau d’ID de groupes de mises à jour logicielles. Cette valeur est l’ID d’CI_ID ou d’élément de configuration du groupe de mises à jour logicielles. Par exemple : 107078.

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

-UpdateGroupName

Spécifiez un tableau de noms de groupes de mises à jour logicielles.

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

-Vendor

S’applique à la version 2010 et ultérieure. Spécifiez le nom du fournisseur de mises à jour logicielles. Le fournisseur de la plupart des mises à jour logicielles est "Microsoft". Si vous configurez des mises à jour logicielles tierces, utilisez cette valeur pour filtrer sur d’autres fournisseurs de mises à jour.

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

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

IResultObject[]

IResultObject

Notes

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