New-CMUserCollection
Créez une collection d’utilisateurs.
Syntax
New-CMUserCollection
[-Comment <String>]
-LimitingCollectionName <String>
-Name <String>
[-RefreshSchedule <IResultObject>]
[-RefreshType <CollectionRefreshType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMUserCollection
[-Comment <String>]
-InputObject <IResultObject>
-Name <String>
[-RefreshSchedule <IResultObject>]
[-RefreshType <CollectionRefreshType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMUserCollection
[-Comment <String>]
-LimitingCollectionId <String>
-Name <String>
[-RefreshSchedule <IResultObject>]
[-RefreshType <CollectionRefreshType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Utilisez cette cmdlet pour créer une collection d’utilisateurs basée sur une collection de limites spécifique. La collection de limitation détermine les utilisateurs qui peuvent être membres de la collection d’utilisateurs que vous créez. Par exemple, lorsque vous utilisez la collection Tous les utilisateurs comme collection de limitation, la nouvelle collection peut inclure n’importe quel utilisateur dans la hiérarchie Configuration Manager.
Vous pouvez ensuite ajouter des utilisateurs à la collection avec des règles d’appartenance. Pour ajouter des membres à la collection d’utilisateurs, utilisez l’une des cmdlets de règle d’appartenance suivantes :
- Add-CMUserCollectionDirectMembershipRule
- Add-CMUserCollectionExcludeMembershipRule
- Add-CMUserCollectionIncludeMembershipRule
- Add-CMUserCollectionQueryMembershipRule
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 pour tous les utilisateurs du service Sales. La spécification de Tous les utilisateurs pour le paramètre LimitingCollectionName indique que la nouvelle collection peut inclure n’importe quel utilisateur dans la hiérarchie configuration manager.
New-CMUserCollection -Name "Sales" -LimitingCollectionName "All Users"
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-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 |
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’utilisateurs.
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