Get-CMSoftwareUpdate
Obtenir une mise à jour logicielle.
Syntax
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 cmdlet pour obtenir une ou plusieurs mises à jour logicielles.
Pour plus d’informations, voir la documentation sur la gestion des mises à jour logicielles dans les documents de base.
Notes
Exécutez les cmdlets Configuration Manager à partir du lecteur de site Configuration Manager, par PS XYZ:\>
exemple. Pour plus d’informations, voir la mise en place.
Exemples
Exemple 1 : Obtenir les mises à jour logicielles téléchargées
Cette commande obtient toutes les mises à jour logicielles téléchargées par le site.
Get-CMSoftwareUpdate -IsContentProvisioned $True
Exemple 2 : Obtenir des mises à jour logicielles par groupe de mises à jour
Cette commande obtient d’abord l’objet groupe de mise à jour logicielle nommé TestSUgroup10. Il utilise ensuite l’opérateur de pipeline pour transmettre 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 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-BulletinId
Spécifiez l’ID bulletin d’une mise à jour logicielle. Par exemple: MS18-952
.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Category
Spécifiez la catégorie d’une mise à jour logicielle. Pour obtenir un objet de catégorie, utilisez l’cmdlet Get-CMSoftwareUpdateCategory.
Type: | IResultObject[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-CategoryName
Spécifiez un tableau de noms de catégorie pour les mises à jour logicielles.
Type: | String[] |
Aliases: | CategoryNames |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DatePostedMax
Spécifiez la date à laquelle une mise à jour logicielle a été publiée au plus tard.
Type: | DateTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DatePostedMin
Spécifiez la date à laquelle une mise à jour logicielle a été publiée au plus tôt.
Type: | DateTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DateRevisedMax
Spécifiez la date à laquelle une mise à jour logicielle a été révisée au plus tard.
Type: | DateTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DateRevisedMin
Spécifiez la date à laquelle une mise à jour logicielle a été révisée au plus tôt.
Type: | DateTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Ce paramètre traite les caractères génériques comme des valeurs littérales. Vous ne pouvez pas la combiner avec ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EulaExist
Définissez ce paramètre pour $true
filtrer les résultats de toutes les mises à jour qui ont un contrat de licence.
Type: | Boolean |
Aliases: | EulaExists |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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 cmdlet.
Si vous n’utilisez pas ce paramètre, la cmdlet affiche un avertissement. Pour désactiver cet avertissement, définissez $CMPSSuppressFastNotUsedCheck = $true
.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
Spécifie l’ID d’une mise à jour logicielle. Cette valeur est la CI_ID, par exemple 143404
.
Type: | Int32 |
Aliases: | CIId, CI_ID |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IncludeUpgrade
Ajoutez ce paramètre pour inclure les mises à jour logicielles dans la catégorie de mise à niveau.
Type: | SwitchParameter |
Aliases: | IncludeUpgrades |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsContentProvisioned
Définissez ce paramètre pour filtrer les résultats de toutes les mises à jour pour lesquelles le $true
site a téléchargé du contenu.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsDeployed
Définissez ce paramètre $true
pour filtrer les résultats de toutes les mises à jour déployées.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsExpired
Définissez ce paramètre pour $true
filtrer les résultats de toutes les mises à jour expirées.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsLatest
Définissez ce paramètre pour $true
filtrer les résultats de la dernière version de la mise à jour logicielle.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsOfflineServiceable
Définissez ce paramètre pour filtrer les résultats de toutes les mises à $true
jour hors connexion utilisables. 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 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsSuperseded
Définissez ce paramètre pour filtrer les résultats de toutes les mises $true
à jour qui sont mises à jour.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsUserDefined
Définissez ce paramètre pour filtrer les résultats de toutes les mises à $true
jour définies par l’utilisateur.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Spécifiez le nom d’une mise à jour logicielle. Ce paramètre est comparé à l’attribut de nom d’affichage local.
Vous pouvez utiliser des caractères génériques :
*
: Plusieurs caractères?
: Caractère unique
Type: | String |
Aliases: | LocalizedDisplayName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-OnlyExpired
Ajoutez ce paramètre pour rechercher uniquement les mises à jour logicielles expirées.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Severity
Spécifiez la gravité de la mise à jour logicielle.
Type: | CustomSeverityType |
Accepted values: | None, Low, Moderate, Important, Critical |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UpdateGroup
Spécifiez l’objet groupe de mise à jour logicielle. Pour obtenir cet objet, utilisez l’cmdlet Get-CMSoftwareUpdateGroup.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-UpdateGroupId
Spécifiez un tableau d’ID de groupes de mises à jour logicielles. Cette valeur est l’CI_ID ou l’ID d’élément de config du groupe de mise à jour logicielle. Par exemple: 107078
.
Type: | String[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UpdateGroupName
Spécifiez un tableau de noms de groupes de mises à jour logicielles.
Type: | String[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Vendor
S’applique aux versions 2010 et ultérieures. Spécifiez le nom du fournisseur de mise à jour logicielle. Le fournisseur de la plupart des mises à jour logicielles est "Microsoft"
. Si vous configurez des mises à jour logicielles tierces, utilisez cette valeur pour filtrer les autres fournisseurs de mises à jour.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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, voir SMS_SoftwareUpdate classe WMI du serveur.