Delen via


New-CMCollection

SYNOPSIS

Hiermee maakt u Configuration Manager verzameling.

SYNTAX

ByName (standaard)

New-CMCollection -CollectionType <CollectionType> [-Comment <String>] -LimitingCollectionName <String>
 -Name <String> [-RefreshSchedule <IResultObject>] [-RefreshType <CollectionRefreshType>]
 [-VariablePriority <Int32>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

ByValue

New-CMCollection -CollectionType <CollectionType> [-Comment <String>] -InputObject <IResultObject>
 -Name <String> [-RefreshSchedule <IResultObject>] [-RefreshType <CollectionRefreshType>]
 [-VariablePriority <Int32>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

ById

New-CMCollection -CollectionType <CollectionType> [-Comment <String>] -LimitingCollectionId <String>
 -Name <String> [-RefreshSchedule <IResultObject>] [-RefreshType <CollectionRefreshType>]
 [-VariablePriority <Int32>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

DESCRIPTION

Met de cmdlet New-CMCollection maakt u een verzameling in Configuration Manager.

Configuration Manager verzamelingen bieden een manier om gebruikers, computers en andere resources in uw organisatie te beheren. Ze bieden u niet alleen een manier om uw resources te organiseren, maar ze bieden u ook een manier om Configuration Manager distribueren naar clients en gebruikers.

Notitie

Voer Configuration Manager cmdlets uit vanaf Configuration Manager sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.

EXAMPLES

Voorbeeld 1: Een verzameling maken en het bereik ervan opgeven

PS XYZ:\> New-CMCollection -CollectionType User -LimitingCollectionName "All Users" -Name "testUser"

Met deze opdracht maakt u een gebruikersverzameling met de naam testUser waarmee de verzameling Alle gebruikers wordt vastgesteld als het bereik van waaruit u leden kunt toevoegen.

Voorbeeld 2: een verzameling maken op basis van een bestaande verzameling

PS XYZ:\> Get-CMCollection -Name "All Users" | New-CMCollection -Name "testUser" -CollectionType "User"

Met deze opdracht haalt u het verzamelingsobject met de naam Alle gebruikers op en gebruikt u de pijplijnoperator om het object door te geven aan New-CMCollection. New-CMCollection maakt een verzameling met de naam testUser die is gebaseerd op het lidmaatschap van de verzameling Alle gebruikers.

PARAMETERS

-CollectionType

Hiermee geeft u een type voor de verzameling. Geldige waarden zijn:

  • Hoofdmap
  • Gebruiker
  • Apparaat
  • Onbekend
Type: CollectionType
Parameter Sets: (All)
Aliases:
Accepted values: User, Device

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Opmerking

Hiermee geeft u een opmerking voor de verzameling.

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

-DisableWildcardHandling

Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag (niet aanbevolen). U kunt deze niet combineren met DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-InputObject

Hiermee geeft u een verzamelingsobject op dat moet worden gebruikt als een bereik voor deze verzameling. Als u een verzamelingsobject wilt ophalen, gebruikt u de cmdlet Get-CMCollection.

Type: IResultObject
Parameter Sets: ByValue
Aliases: LimitingCollection

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-LimitingCollectionId

Hiermee geeft u de id op van een verzameling die moet worden gebruikt als een bereik voor deze verzameling.

Type: String
Parameter Sets: ById
Aliases: LimitToCollectionId

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-LimitingCollectionName

Hiermee geeft u de naam op van een verzameling die moet worden gebruikt als een bereik voor deze verzameling.

Type: String
Parameter Sets: ByName
Aliases: LimitToCollectionName

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Name

Hiermee geeft u een naam op voor de verzameling.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-RefreshSchedule

Hiermee geeft u een schema op dat bepaalt wanneer Configuration Manager verzameling vernieuwt.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-RefreshType

Hiermee geeft u Configuration Manager de verzameling wordt vernieuwd. Geldige waarden zijn:

  • Geen
  • Handmatig
  • Periodieke
  • Continu
  • Beide
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

-VariablePriority

{{ Fill VariablePriority Description }}

Type: Int32
Parameter Sets: (All)
Aliases: DeviceCollectionVariablePrecedence

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

IResultObject#SMS_Collection

OPMERKINGEN

Export-CMCollection

Get-CMCollection

Import-CMCollection

Remove-CMCollection

Set-CMCollection