Delen via


Set-CMCollection

SYNOPSIS

Hiermee stelt u Configuration Manager verzameling.

SYNTAX

SetByValue (standaard)

Set-CMCollection [-Comment <String>] -InputObject <IResultObject> [-LimitingCollection <IResultObject>]
 [-LimitingCollectionId <String>] [-LimitingCollectionName <String>] [-NewName <String>] [-PassThru]
 [-RefreshSchedule <IResultObject>] [-RefreshType <CollectionRefreshType>] [-VariablePriority <Int32>]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SetById

Set-CMCollection -CollectionId <String> [-Comment <String>] [-LimitingCollection <IResultObject>]
 [-LimitingCollectionId <String>] [-LimitingCollectionName <String>] [-NewName <String>] [-PassThru]
 [-RefreshSchedule <IResultObject>] [-RefreshType <CollectionRefreshType>] [-VariablePriority <Int32>]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SetByName

Set-CMCollection [-Comment <String>] [-LimitingCollection <IResultObject>] [-LimitingCollectionId <String>]
 [-LimitingCollectionName <String>] -Name <String> [-NewName <String>] [-PassThru]
 [-RefreshSchedule <IResultObject>] [-RefreshType <CollectionRefreshType>] [-VariablePriority <Int32>]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

De cmdlet Set-CMCollection wijzigt de instellingen voor 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 ophalen en wijzigen

PS XYZ:\> $userCollection = Get-CMCollection -Name "testUser"
PS XYZ:\> Set-CMCollection -CollectionId $userCollection -NewName "newTestUser"

De eerste opdracht haalt het verzamelingsobject met de naam testUser op en slaat het object op in de $userCollection variabele.

Met de tweede opdracht wordt de naam van de verzameling in $userCollection.

Voorbeeld 2: Een verzameling doorgeven en wijzigen

PS XYZ:\> Get-CMCollection -Name "testUser" | Set-CMCollection -NewName "newTestUser"

Met deze opdracht wordt het verzamelingsobject met de naam testUser ophaald en wordt de pijplijnoperator gebruikt om het object door te geven aan Set-CMCollection, waarmee de naam wordt bijgewerkt naar newTestUser.

PARAMETERS

-CollectionId

Hiermee geeft u een verzamelings-id op.

Type: String
Parameter Sets: SetById
Aliases:

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. Als u een verzamelingsobject wilt ophalen, gebruikt u de cmdlet Get-CMCollection.

Type: IResultObject
Parameter Sets: SetByValue
Aliases: Collection

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

-LimitingCollection

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: (All)
Aliases:

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

-LimitingCollectionId

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

Type: String
Parameter Sets: (All)
Aliases: LimitToCollectionId

Required: False
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: (All)
Aliases: LimitToCollectionName

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

-Name

Hiermee geeft u de naam van een verzameling.

Type: String
Parameter Sets: SetByName
Aliases:

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

-NewName

Hiermee geeft u een nieuwe naam op voor de verzameling.

Type: String
Parameter Sets: (All)
Aliases:

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

-PassThru

Voeg deze parameter toe om een -object te retourneren dat het item vertegenwoordigt waarmee u werkt. Standaard is het mogelijk dat deze cmdlet geen uitvoer genereert.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
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

System.Object

OPMERKINGEN

Get-CMCollection

Export-CMCollection

Import-CMCollection

New-CMCollection

Remove-CMCollection