Partager via

Set-CMCollection

  • Référence
Module:
ConfigurationManager

Configurer un regroupement d’appareils ou d’utilisateurs.

Syntaxe

Set-CMCollection
   [-Comment <String>]
   -InputObject <IResultObject>
   [-LimitingCollection <IResultObject>]
   [-LimitingCollectionId <String>]
   [-LimitingCollectionName <String>]
   [-NewName <String>]
   [-PassThru]
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-VariablePriority <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMCollection
   -CollectionId <String>
   [-Comment <String>]
   [-LimitingCollection <IResultObject>]
   [-LimitingCollectionId <String>]
   [-LimitingCollectionName <String>]
   [-NewName <String>]
   [-PassThru]
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-VariablePriority <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMCollection
   [-Comment <String>]
   [-LimitingCollection <IResultObject>]
   [-LimitingCollectionId <String>]
   [-LimitingCollectionName <String>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-VariablePriority <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Utilisez cette applet de commande pour configurer un regroupement d’appareils ou d’utilisateurs.

La limitation de la collection détermine quelles ressources peuvent être membres de la collection. Par exemple, lorsque vous utilisez le regroupement Tous les systèmes comme regroupement de limitation, le nouveau regroupement peut inclure n’importe quel appareil dans la hiérarchie Configuration Manager.

Ajoutez des ressources à la collection avec des règles d’appartenance. Pour ajouter des membres à la collection, utilisez l’une des applets de commande pour ajouter des règles d’appartenance, par exemple :

Vous ne pouvez pas configurer les regroupements par défaut. Toute collection que vous ciblez doit avoir un ID qui commence par le code de site, et non SMS.

Pour plus d’informations, consultez How to create collections in Configuration Manager.

Remarque

Exécutez Configuration Manager applets de commande à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1 : Renommer une collection

La première commande obtient l’objet de collection nommé testUser et le stocke dans la variable $userCollection .

La deuxième commande met à jour le nom de la collection.

$userCollection = Get-CMCollection -Name "testUser"
Set-CMCollection -InputObject $userCollection -NewName "newTestUser"

Paramètres

-CollectionId

Spécifiez l’ID du regroupement à configurer. Cette valeur est la propriété CollectionID, par exemple . XYZ00012 Vous ne pouvez pas configurer les collections par défaut, donc cette valeur commence par le code du site, et non SMSpar .

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

-Comment

Spécifiez un commentaire facultatif pour décrire et identifier cette collection.

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

-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 à configurer. Pour obtenir cet objet, utilisez les applets de commande Get-CMCollection, Get-CMDeviceCollection ou Get-CMUserCollection .

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

-LimitingCollection

Spécifiez un objet pour la collection de limitation. 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:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-LimitingCollectionId

Spécifiez l’ID de la collection de limitation. Cette valeur est la propriété CollectionID , par exemple ou XYZ00012SMS00001.

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

-LimitingCollectionName

Spécifiez le nom de la collection de limitation.

Type:String
Alias:LimitToCollectionName
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’un regroupement à configurer.

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

-NewName

Spécifiez un nouveau nom pour la collection. Utilisez ce paramètre pour le renommer.

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

-PassThru

Ajoutez ce paramètre pour renvoyer un objet qui représente l’élément avec lequel vous travaillez. Par défaut, cette applet de commande peut ne pas générer de sortie.

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

-RefreshSchedule

Si vous définissez le paramètre RefreshType sur Periodic ou Both, utilisez ce paramètre pour définir la planification. Spécifiez un objet de planification pour le moment où le site exécute une mise à jour complète de l’appartenance à la collection. Pour obtenir cet objet, utilisez l’applet de commande New-CMSchedule .

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

-RefreshType

Spécifiez la façon dont l’appartenance à la collection est mise à jour :

  • Manual(1) : un administrateur déclenche manuellement une mise à jour d’appartenance dans la console Configuration Manager ou avec l’applet de commande Invoke-CMCollectionUpdate.
  • Periodic (2) : le site effectue une mise à jour complète selon une planification. Il n’utilise pas les mises à jour incrémentielles. Si vous ne spécifiez pas de type, cette valeur est la valeur par défaut.
  • Continuous (4) : le site évalue régulièrement les nouvelles ressources, puis ajoute de nouveaux membres. Ce type est également appelé mise à jour incrémentielle. Il n’effectue pas de mise à jour complète selon une planification.
  • Both (6) : combinaison de Periodic et Continuous, avec des mises à jour incrémentielles et une mise à jour complète selon une planification.

Si vous spécifiez Periodic ou Both, utilisez le paramètre RefreshSchedule pour définir la planification.

Remarque

La None valeur (0) est fonctionnellement identique à Manual.

Type:CollectionRefreshType
Valeurs acceptées:None, Manual, Periodic, Continuous, Both
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-VariablePriority

Spécifiez une valeur entière comprise entre 1 et 9 pour la priorité des variables de regroupement d’appareils. 1 est la priorité la plus basse et 9 est la plus élevée.

Pour configurer des variables sur un regroupement d’appareils, utilisez l’applet de commande Set-CMDeviceCollectionVariable .

Pour afficher la priorité actuelle de la variable, utilisez l’applet de commande Get-CMCollectionSetting .

Type:Int32
Alias:DeviceCollectionVariablePrecedence
Position:Named
Valeur par défaut:None
Obligatoire:False
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