Rename-CMCategory
SYNOPSIS
Hiermee wijzigt u de naam van een categorie.
SYNTAX
RenameCategoryByValue (standaard)
Rename-CMCategory -InputObject <IResultObject> -NewName <String> [-PassThru] [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
RenameCategoryByName
Rename-CMCategory -CategoryType <CategoryType> -Name <String> -NewName <String> [-PassThru]
[-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Met de cmdlet Rename-CMCategory wordt de naam van een categorie-exemplaar gewijzigd.
Notitie
Voer Configuration Manager cmdlets uit vanaf Configuration Manager-sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.
EXAMPLES
Voorbeeld 1: De naam van een categorie wijzigen door een categorieobject op te geven
PS ABC:\> $Category = Get-CMCategory -Name "Category01" -CategoryType BaselineCategories
PS ABC:\> Rename-CMCategory -InputObject $Category -NewName "NewCategory01"
De eerste opdracht haalt het categorieobject op met de naam Category01 van het type BaselineCategories en slaat het object op in de $Category variabele.
Met de tweede opdracht wordt de categorie die is opgeslagen in $Category gewijzigd in NewCategory01.
Voorbeeld 2: De naam van een categorie wijzigen op naam en type
PS ABC:\> Rename-CMCategory -Name "Category02" -NewName "NewCategory02" -CategoryType BaselineCategories
Met deze opdracht wordt de categorie met de naam Category02 van het type BaseineCategories gewijzigd in NewCategory02.
Voorbeeld 3: De naam van een categorie wijzigen door een categorieobject door te geven via de pijplijn
PS ABC:\> Get-CMCategory -Name "Category03" -CategoryType BaselineCategories | Rename-CMCategory -NewName "NewCategory03"
Met deze opdracht wordt het categorieobject met de naam Category03 van het type BaselineCategories en wordt de pijplijnoperator gebruikt om het object door te geven aan Rename-CMCategory, waarmee de naam van de categorie wordt gewijzigd in NewCategory03.
PARAMETERS
-CategoryType
Hiermee geeft u een categorietype. Geldige waarden zijn:
- AppCategories
- Basislijncategorieën
- CatalogCategories
- DriverCategories
- UserCategories
Type: CategoryType
Parameter Sets: RenameCategoryByName
Aliases:
Accepted values: AppCategories, BaselineCategories, CatalogCategories, DriverCategories, UserCategories
Required: True
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 object van een categorie-exemplaar op. Gebruik de cmdlet Get-CMCategory om een object voor een categorie-exemplaar op te halen.
Type: IResultObject
Parameter Sets: RenameCategoryByValue
Aliases: Category
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Name
Hiermee geeft u de naam van een categorie-exemplaar.
Type: String
Parameter Sets: RenameCategoryByName
Aliases: LocalizedCategoryInstanceName, CategoryName
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-NewName
Hiermee geeft u een nieuwe naam op voor het categorie-exemplaar.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
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
-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.