Rename-CMCategory
SYNOPSIS
Byter namn på en kategori.
SYNTAX
RenameCategoryByValue (standard)
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
Cmdleten Rename-CMCategory byter namn på en kategoriinstans.
Anteckning
Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenhet, till exempel PS XYZ:\>
. Mer information finns i Komma igång.
EXAMPLES
Exempel 1: Byt namn på en kategori genom att hämta ett kategoriobjekt
PS ABC:\> $Category = Get-CMCategory -Name "Category01" -CategoryType BaselineCategories
PS ABC:\> Rename-CMCategory -InputObject $Category -NewName "NewCategory01"
Det första kommandot hämtar kategoriobjektet med namnet Category01 av typen BaselineCategories och lagrar objektet i $Category variabeln.
Det andra kommandot byter namn på kategorin som lagras i $Category till NewCategory01.
Exempel 2: Byt namn på en kategori efter dess namn och typ
PS ABC:\> Rename-CMCategory -Name "Category02" -NewName "NewCategory02" -CategoryType BaselineCategories
Det här kommandot byter namn på kategorin category02 av typen BaseineCategories till NewCategory02.
Exempel 3: Byt namn på en kategori genom att skicka ett kategoriobjekt via pipelinen
PS ABC:\> Get-CMCategory -Name "Category03" -CategoryType BaselineCategories | Rename-CMCategory -NewName "NewCategory03"
Det här kommandot hämtar kategoriobjektet Category03 av typen BaselineCategories och använder pipelineoperatorn för att skicka objektet till Rename-CMCategory, som byter namn på kategorin till NewCategory03.
PARAMETERS
-CategoryType
Anger en kategorityp. Giltiga värden är:
- AppCategories
- BaselineCategories
- 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
Uppmanar dig att bekräfta innan du kör cmdleten.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Anger ett kategoriinstansobjekt. Om du vill hämta ett kategoriinstansobjekt använder du cmdleten Get-CMCategory.
Type: IResultObject
Parameter Sets: RenameCategoryByValue
Aliases: Category
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Name
Anger namnet på en kategoriinstans.
Type: String
Parameter Sets: RenameCategoryByName
Aliases: LocalizedCategoryInstanceName, CategoryName
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-NewName
Anger ett nytt namn för kategoriinstansen.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PassThru
Lägg till den här parametern för att returnera ett objekt som representerar det objekt som du arbetar med. Som standard genererar denna cmdlet kanske inte några utdata.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.