Rename-CMCategory
SYNOPSIS
Renomeia uma categoria.
SYNTAX
RenomeCategoryByValue (Padrão)
Rename-CMCategory -InputObject <IResultObject> -NewName <String> [-PassThru] [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
RenomeAdoCategoryByName
Rename-CMCategory -CategoryType <CategoryType> -Name <String> -NewName <String> [-PassThru]
[-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
O cmdlet rename-CMCategory renomeia uma instância de categoria.
Nota
Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\> . Para mais informações, consulte a partida.
EXAMPLES
Exemplo 1: Mudar de categoria para mudar de categoria obtendo um objeto de categoria
PS ABC:\> $Category = Get-CMCategory -Name "Category01" -CategoryType BaselineCategories
PS ABC:\> Rename-CMCategory -InputObject $Category -NewName "NewCategory01"
O primeiro comando obtém o objeto de categoria 01 do tipo BaselineCategories e armazena o objeto na variável $Category.
O segundo comando renomea a categoria armazenada em $Category para a NewCategory01.
Exemplo 2: Mudar de categoria pelo seu nome e tipo
PS ABC:\> Rename-CMCategory -Name "Category02" -NewName "NewCategory02" -CategoryType BaselineCategories
Este comando renomea a categoria 02 do tipo BaseineCategories para NewCategory02.
Exemplo 3: Mudar o nome de uma categoria passando um objeto de categoria através do oleoduto
PS ABC:\> Get-CMCategory -Name "Category03" -CategoryType BaselineCategories | Rename-CMCategory -NewName "NewCategory03"
Este comando obtém o objeto de categoria 03 do tipo BaselineCategories e utiliza o operador do oleoduto para passar o objeto para Renome-CMCategoria, que renomea a categoria para NewCategory03.
PARAMETERS
-CategoriaType
Especifica um tipo de categoria. Os valores válidos são:
- AppCategories
- Linhas de Base
- CatálogoCategorias
- 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
Solicita a sua confirmação antes de executar o cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Este parâmetro trata os caracteres wildcard como valores de caracteres literais. Não pode combiná-lo com ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Este parâmetro processa caracteres wildcard e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Especifica um objeto de instância de categoria. Para obter um objeto de instância de categoria, utilize o 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
Especifica o nome de uma instância de categoria.
Type: String
Parameter Sets: RenameCategoryByName
Aliases: LocalizedCategoryInstanceName, CategoryName
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-Novo Nome
Especifica um novo nome para a instância da categoria.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
- PassThru
Adicione este parâmetro para devolver um objeto que represente o item com o qual está a trabalhar. Por predefinição, este cmdlet pode não gerar qualquer saída.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
- O QueIf
Apresenta o que aconteceria mediante a execução do cmdlet. O comandante não funciona.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.