Partager via

Invoke-CMCollectionUpdate

  • Référence
Module:
ConfigurationManager

Mettre à jour l’appartenance d’une collection.

Syntaxe

Invoke-CMCollectionUpdate
      -InputObject <IResultObject>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Invoke-CMCollectionUpdate
      -CollectionId <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Invoke-CMCollectionUpdate
      -Name <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Utilisez cette applet de commande pour mettre à jour l’appartenance d’une collection. Le site évalue l’appartenance de la collection sélectionnée en fonction des règles d’appartenance de la collection. Pour les regroupements avec de nombreux membres, cette mise à jour peut prendre un certain temps.

Pour plus d’informations, consultez Évaluation de regroupement 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 : Mettre à jour l’appartenance d’une collection à l’aide du pipeline

Cette commande obtient l’objet de collection avec l’ID de XYZ00014 et utilise l’opérateur de pipeline pour passer l’objet à Invoke-CMCollectionUpdate, ce qui met à jour l’appartenance de la collection.

Get-CMCollection -Id XYZ00014 | Invoke-CMCollectionUpdate

Exemple 2 : Mettre à jour l’appartenance d’une collection par nom

Cette commande met à jour l’appartenance à la collection nommée UserCol1.

Invoke-CMCollectionUpdate -Name "UserCol1"

Paramètres

-CollectionId

Spécifiez l’ID de la collection à mettre à jour. Cette valeur est la propriété CollectionID , par exemple, XYZ00012 ou SMS00001.

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

-Confirm

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
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

-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

-InputObject

Spécifiez un objet de collection à mettre à jour. Pour obtenir cet objet, utilisez les applets de commande Get-CMCollection, Get-CMDeviceCollection ou Get-CMUserCollection .

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

-Name

Spécifiez le nom d’une collection à mettre à jour.

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

-WhatIf

Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.

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

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

System.Object