New-CMDeviceCollection

Référence

Module:: ConfigurationManager

Créez une collection d’appareils.

Syntax

New-CMDeviceCollection
   [-Comment <String>]
   -LimitingCollectionName <String>
   -Name <String>
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMDeviceCollection
   [-Comment <String>]
   -InputObject <IResultObject>
   -Name <String>
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMDeviceCollection
   [-Comment <String>]
   -LimitingCollectionId <String>
   -Name <String>
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Utilisez cette cmdlet pour créer une collection d’appareils basée sur une collection de limites spécifique. La collection de limitations détermine les appareils qui peuvent être membres de la collection d’appareils que vous créez. Par exemple, lorsque vous utilisez la collection Tous les systèmes comme collection de limitation, la nouvelle collection peut inclure n’importe quel appareil dans la hiérarchie Configuration Manager.

Vous pouvez ensuite ajouter des appareils à la collection avec des règles d’appartenance. Pour ajouter des membres à la collection d’appareils, utilisez l’une des cmdlets de règle d’appartenance suivantes :

Pour plus d’informations, voir Comment créer des collections dans Configuration Manager.

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 : créer une collection d’appareils

Cette commande crée une collection pour tous les ordinateurs qui exécutent Windows 11. Le paramètre LimitingCollectionName spécifie que tout appareil de la collection All Systems peut être membre de la nouvelle collection.

New-CMDeviceCollection -Name "Windows 11" -LimitingCollectionName "All Systems"

Paramètres

- Confirmer

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

- WhatIf

Présente ce qui se produit si le cmdlet s’exécute. La cmdlet ne s’exécute pas.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Comment

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Spécifiez un objet pour la collection limiting. Pour obtenir cet objet, utilisez les cmdlets Get-CMCollection ou Get-CMDeviceCollection.

Type:	IResultObject
Aliases:	LimitingCollection
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-LimitingCollectionId

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-LimitingCollectionName

Spécifiez le nom de la collection de limitation.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Spécifiez le nom de la nouvelle collection d’appareils.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RefreshSchedule

Si vous définissez le paramètre RefreshType sur l’une ou l’autre des valeurs, utilisez Periodic ce paramètre pour définir la Both 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’cmdlet New-CMSchedule.

Type:	IResultObject
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RefreshType

Spécifiez comment l’appartenance à la collection est mise à jour :

Manual(1) : un administrateur déclenche manuellement une mise à jour de l’appartenance dans la console Configuration Manager ou avec l’cmdlet Invoke-CMCollectionUpdate.
Periodic (2) : le site fait une mise à jour complète selon une planification. Il n’utilise pas de 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 ne fait pas de mise à jour complète selon une planification.
Both (6) : combinaison des deux et, avec des mises à jour incrémentielles et une mise à Periodic jour complète selon une Continuous planification.

Si vous spécifiez l’une ou l’autre des valeurs, utilisez Periodic Both le paramètre RefreshSchedule pour définir la planification.