Partager via

Get-CMConfigurationItem

  • Référence
Module:
ConfigurationManager

Obtient les éléments de configuration Configuration Manager.

Syntaxe

Get-CMConfigurationItem
   [-Fast]
   [[-Name] <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMConfigurationItem
   [-Fast]
   [-Id] <Int32>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

L’applet de commande Get-CMConfigurationItem obtient les objets d’élément de configuration dans Configuration Manager. Vous pouvez utiliser cette applet de commande pour obtenir les éléments que d’autres applets de commande doivent utiliser. Par exemple, vous pouvez obtenir des éléments de configuration afin de pouvoir utiliser les Set-CMConfigurationItem pour modifier leurs paramètres.

Les éléments de configuration contiennent un ou plusieurs paramètres, ainsi que des règles de conformité. Pour plus d’informations sur les éléments de configuration, consultez Présentation des paramètres de conformité dans Configuration Manager.

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 un élément à l’aide d’un nom

PS XYZ:\> Get-CMConfigurationItem -Name "ConfigItem76"

Cette commande obtient un élément de configuration nommé ConfigItem76.

Exemple 2 : Obtenir un élément à utiliser avec une autre applet de commande

PS XYZ:\> $CIObj=Get-CMConfigurationItem -Id "16777568"
PS XYZ:\> Remove-CMConfigurationItem -InputObject $CIObj

La première commande obtient un élément de configuration avec l’identificateur spécifié et le stocke dans la variable $CIObj.

La deuxième commande supprime l’élément dans la variable $CIObj.

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

Indique que l’applet de commande n’actualise pas 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, ce qui peut entraîner un trafic réseau supplémentaire et réduire les performances des applets de commande. Si des propriétés différées ne sont pas nécessaires, ce paramètre doit être spécifié.

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 un tableau d’identificateurs pour un ou plusieurs éléments de configuration. Vous pouvez utiliser une liste séparée par des virgules.

Type:Int32
Alias:CIId, CI_ID
Position:0
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 un tableau de noms d’éléments de configuration. Vous pouvez utiliser une liste séparée par des virgules.

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

Entrées

None

Sorties

IResultObject[]

IResultObject