Get-CMPackage

  • Référence
Module:
ConfigurationManager

Obtenez un package hérité Configuration Manager.

Syntaxe

Get-CMPackage
   [-Fast]
   [-Name <String>]
   [-PackageType <PackageType>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMPackage
   [-Fast]
   -Id <String>
   [-PackageType <PackageType>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

L’applet de commande Get-CMPackage obtient un package hérité Configuration Manager. Configuration Manager Current Branch continue de prendre en charge les packages et les programmes utilisés dans Configuration Manager 2007. Pour plus d’informations, consultez Packages et programmes dans Configuration Manager.

D’autres objets sont considérés comme des « packages » dans certains contextes, mais vous devez utiliser d’autres applets de commande pour les obtenir. Pour plus d’informations, consultez les liens connexes.

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 tous les packages

Cette commande obtient tous les packages hérités Configuration Manager et les stocke dans les packages de variables.

$packages = Get-CMPackage -PackageType RegularPackage

Exemple 2 : Obtenir un package à l’aide d’un ID

Cette commande obtient le package qui a l’ID CM100002.

Get-CMPackage -Id "CM100002"

Exemple 3 : Obtenir un package à l’aide d’un nom

Cette commande obtient le package nommé Package client Configuration Manager.

Get-CMPackage -Name "Configuration Manager Client Package"

Paramètres

-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

-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 de package à obtenir. Par exemple : "CM100002".

Type:String
Alias:PackageId
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écifie le nom d’un package à obtenir. Par exemple : "Configuration Manager Client Package".

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

-PackageType

Spécifiez un type de package pour filtrer le résultat.

Type:PackageType
Valeurs acceptées:RegularPackage, Driver, TaskSequence, SoftwareUpdate, ContentPackage, ImageDeployment, BootImage, OSInstallPackage
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

None

Sorties

IResultObject[]

IResultObject

Notes

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