New-CMCollection
Créez un appareil ou une collection d’utilisateurs.
Syntax
New-CMCollection
-CollectionType <CollectionType>
[-Comment <String>]
-LimitingCollectionName <String>
-Name <String>
[-RefreshSchedule <IResultObject>]
[-RefreshType <CollectionRefreshType>]
[-VariablePriority <Int32>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMCollection
-CollectionType <CollectionType>
[-Comment <String>]
-InputObject <IResultObject>
-Name <String>
[-RefreshSchedule <IResultObject>]
[-RefreshType <CollectionRefreshType>]
[-VariablePriority <Int32>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMCollection
-CollectionType <CollectionType>
[-Comment <String>]
-LimitingCollectionId <String>
-Name <String>
[-RefreshSchedule <IResultObject>]
[-RefreshType <CollectionRefreshType>]
[-VariablePriority <Int32>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Utilisez cette cmdlet pour créer un appareil ou une collection d’utilisateurs.
La collection limiting détermine les ressources qui peuvent être membres de la collection que vous créez. Par exemple, lorsque vous utilisez la collection Tous les systèmes comme collection de limites, étant donné qu’il s’agit d’une collection d’appareils, la nouvelle collection d’appareils peut inclure n’importe quel appareil dans la hiérarchie Configuration Manager.
Pour l’étendue du type de collection que vous créez, vous pouvez également utiliser les cmdlets New-CMDeviceCollection ou New-CMUserCollection.
Après avoir créé une collection, ajoutez des ressources à la collection avec des règles d’appartenance. Pour ajouter des membres à la collection, utilisez l’une des cmdlets pour ajouter des règles d’appartenance, par exemple :
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’utilisateurs
Cette commande crée une collection d’utilisateurs nommée testUser qui définit la collection All Users comme collection de limitation.
New-CMCollection -CollectionType User -LimitingCollectionName "All Users" -Name "testUser"
Exemple 2 : définir la collection de limites via le pipeline
Cette commande utilise d’abord Get-CMCollection pour obtenir l’objet de collection All Users. Il utilise ensuite l’opérateur de pipeline pour transmettre l’objet à l’cmdlet New-CMCollection, qui crée une collection nommée testUser. La collection limiting pour la nouvelle collection testUser est la collection All Users.
Get-CMCollection -Name "All Users" | New-CMCollection -Name "testUser" -CollectionType "User"
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 |
-CollectionType
Spécifiez le type de collection à créer. Ce paramètre est fonctionnellement identique à l’utilisation des cmdlets New-CMDeviceCollection ou New-CMUserCollection.
Type: | CollectionType |
Accepted values: | User, Device |
Position: | Named |
Default value: | None |
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 |
-DisableWildcardHandling
Ce paramètre traite les caractères génériques comme des valeurs littérales. Vous ne pouvez pas la combiner avec ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
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, Get-CMDeviceCollectionou Get-CMUserCollection.
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 |
Aliases: | LimitToCollectionId |
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 |
Aliases: | LimitToCollectionName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Spécifiez le nom de la nouvelle collection.
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 |
-VariablePriority
Spécifiez une valeur d’ensemble de 1 à 9 pour la priorité des variables de collection d’appareils. 1
est la priorité la plus faible et 9
la plus élevée.
Pour créer des variables sur une collection d’appareils, utilisez l’cmdlet New-CMDeviceCollectionVariable.
Type: | Int32 |
Aliases: | DeviceCollectionVariablePrecedence |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entrées
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Sorties
IResultObject
Notes
Pour plus d’informations sur cet objet de retour et ses propriétés, voir SMS_Collection classe WMI du serveur.
Liens associés
- Copy-CMCollection
- Export-CMCollection
- Get-CMCollection
- Get-CMCollectionMember
- Get-CMCollectionSetting
- Import-CMCollection
- Invoke-CMCollectionUpdate
- Remove-CMCollection
- Set-CMCollection
- New-CMDeviceCollectionVariable
- New-CMDeviceCollection
- New-CMUserCollection
- Comment créer des collections dans Configuration Manager