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 $TrueExemple 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-CMSoftwareUpdateParamè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.