New-CMUserCollection
SYNOPSIS
Hiermee maakt u een verzameling voor gebruikers en voegt u de verzameling toe aan de Configuration Manager hiërarchie.
SYNTAX
ByName (standaard)
New-CMUserCollection [-Comment <String>] -LimitingCollectionName <String> -Name <String>
[-RefreshSchedule <IResultObject>] [-RefreshType <CollectionRefreshType>] [-WhatIf] [-Confirm]
[<CommonParameters>]
ByValue
New-CMUserCollection [-Comment <String>] -InputObject <IResultObject> -Name <String>
[-RefreshSchedule <IResultObject>] [-RefreshType <CollectionRefreshType>] [-WhatIf] [-Confirm]
[<CommonParameters>]
ById
New-CMUserCollection [-Comment <String>] -LimitingCollectionId <String> -Name <String>
[-RefreshSchedule <IResultObject>] [-RefreshType <CollectionRefreshType>] [-WhatIf] [-Confirm]
[<CommonParameters>]
DESCRIPTION
Met de cmdlet New-CMUserCollection wordt een verzameling gemaakt op basis van een specifieke beperkende verzameling. De beperkende verzameling bepaalt welke gebruikers lid kunnen zijn van de gebruikersverzameling die u maakt. Als u bijvoorbeeld de verzameling Alle gebruikers als beperkende verzameling gebruikt, kan de nieuwe verzameling elke gebruiker in de hiërarchie Configuration Manager opnemen. U geeft de beperkende verzameling op door de naam of id op te geven.
Gebruikers worden toegevoegd aan de verzameling op lidmaatschapsregels. Als u leden wilt toevoegen aan de gebruikersverzameling, gebruikt u een van de volgende lidmaatschapsregel-cmdlets:
- Add-CMDeviceCollectionQueryMembershipRule
- Add-CMUserCollectionDirectMembershipRule
- Add-CMUserCollectionExcludeMembershipRule
- Add-CMUserCollectionIncludeMembershipRule
Verzamelingen vertegenwoordigen logische groeperingen van resources, zoals gebruikers en apparaten. Zie Introduction to Collections in Configuration Manager (Inleiding tot verzamelingen in Configuration Manager) voor meer informatie over Configuration Manager verzamelingen.
Notitie
Voer Configuration Manager cmdlets uit vanaf Configuration Manager-sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.
EXAMPLES
Voorbeeld 1: Een gebruikersverzameling maken
PS XYZ:\> New-CMUserCollection -Name "Sales" -LimitingCollectionName "All Users"
Met deze opdracht maakt u een verzameling voor alle gebruikers op de afdeling Verkoop. Als u Alle gebruikers opgeeft voor de parameter LimitingCollectionName, geeft u aan dat de nieuwe verzameling elke gebruiker in de hiërarchie van Configuration Manager kan opnemen.
PARAMETERS
-Opmerking
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Hiermee geeft u de invoer voor deze cmdlet. U kunt deze parameter gebruiken of u kunt de invoer doorseen naar deze cmdlet.
Type: IResultObject
Parameter Sets: ByValue
Aliases: LimitingCollection
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-LimitingCollectionId
Type: String
Parameter Sets: ById
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-LimitingCollectionName
Type: String
Parameter Sets: ByName
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RefreshSchedule
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RefreshType
Type: CollectionRefreshType
Parameter Sets: (All)
Aliases:
Accepted values: None, Manual, Periodic, Continuous, Both
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.
INPUTS
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
OUTPUTS
System.Object
OPMERKINGEN
RELATED LINKS
Add-CMDeviceCollectionQueryMembershipRule
Add-CMUserCollectionDirectMembershipRule
Add-CMUserCollectionExcludeMembershipRule