New-CMDeviceCollection
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 :
- Add-CMDeviceCollectionDirectMembershipRule
- Add-CMDeviceCollectionExcludeMembershipRule
- Add-CMDeviceCollectionIncludeMembershipRule
- Add-CMDeviceCollectionQueryMembershipRule
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 uneContinuous
planification.
Si vous spécifiez l’une ou l’autre des valeurs, utilisez Periodic
Both
le paramètre RefreshSchedule pour définir la planification.
Notes
La None
valeur (0) est fonctionnellement identique à Manual
.
Type: | CollectionRefreshType |
Accepted values: | None, Manual, Periodic, Continuous, Both |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entrées
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Sorties
System.Object