Rename-CMCategory
SYNOPSIS
Zmienia nazwę kategorii.
SYNTAX
RenameCategoryByValue (wartość domyślna)
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
Polecenie cmdlet Rename-CMCategory zmienia nazwę wystąpienia kategorii.
Uwaga
Uruchom Menedżer konfiguracji cmdlet z Menedżer konfiguracji lokacji, na przykład PS XYZ:\> . Aby uzyskać więcej informacji, zobacz wprowadzenie.
EXAMPLES
Przykład 1: Zmiana nazwy kategorii przez uzyskanie obiektu kategorii
PS ABC:\> $Category = Get-CMCategory -Name "Category01" -CategoryType BaselineCategories
PS ABC:\> Rename-CMCategory -InputObject $Category -NewName "NewCategory01"
Pierwsze polecenie pobiera obiekt kategorii o nazwie Category01 typu BaselineCategories i zapisuje obiekt w $Category zmiennej.
Drugie polecenie zmienia nazwę kategorii przechowywanej w $Category na NewCategory01.
Przykład 2: Zmiana nazwy kategorii według jej nazwy i typu
PS ABC:\> Rename-CMCategory -Name "Category02" -NewName "NewCategory02" -CategoryType BaselineCategories
To polecenie zmienia nazwę kategorii o nazwie Category02 typu BaseineCategories na NewCategory02.
Przykład 3: Zmiana nazwy kategorii przez przekazanie obiektu kategorii za pośrednictwem potoku
PS ABC:\> Get-CMCategory -Name "Category03" -CategoryType BaselineCategories | Rename-CMCategory -NewName "NewCategory03"
To polecenie pobiera obiekt kategorii o nazwie Category03 typu BaselineCategories i używa operatora potoku, aby przekazać obiekt do polecenia Rename-CMCategory, które zmienia nazwę kategorii na NewCategory03.
PARAMETERS
-CategoryType
Określa typ kategorii. Prawidłowe wartości:
- 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
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Ten parametr traktuje symbole wieloznaczne jako wartości literału znaków. Nie można połączyć go z forceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Ten parametr przetwarza symbole wieloznaczne i może prowadzić do nieoczekiwanego zachowania (nie jest zalecane). Nie można połączyć go z disableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Określa obiekt wystąpienia kategorii. Aby uzyskać obiekt wystąpienia kategorii, użyj polecenia cmdlet 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
Określa nazwę wystąpienia kategorii.
Type: String
Parameter Sets: RenameCategoryByName
Aliases: LocalizedCategoryInstanceName, CategoryName
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-NewName
Określa nową nazwę wystąpienia kategorii.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PassThru
Dodaj ten parametr, aby zwrócić obiekt reprezentujący element, z którym pracujesz. Domyślnie to polecenie cmdlet może nie generować żadnych danych wyjściowych.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie jest uruchamiane.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
Typowe parametry
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.