Share via

Rename-CMCategory

  • Referência
Módulo:
ConfigurationManager

Renomeia uma categoria.

Syntax

Rename-CMCategory
      -InputObject <IResultObject>
      -NewName <String>
      [-PassThru]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
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.

Observação

Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, confira introdução.

Exemplos

Exemplo 1: renomear uma 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 denominado Category01 do tipo BaselineCategories e armazena o objeto na variável $Category.

O segundo comando renomeia a categoria armazenada em $Category para NewCategory01.

Exemplo 2: renomear uma categoria por seu nome e tipo

PS ABC:\> Rename-CMCategory -Name "Category02" -NewName "NewCategory02" -CategoryType BaselineCategories

Este comando renomeia a categoria chamada Categoria02 do tipo BaseineCategories para NewCategory02.

Exemplo 3: renomear uma categoria passando um objeto de categoria pelo pipeline

PS ABC:\> Get-CMCategory -Name "Category03" -CategoryType BaselineCategories | Rename-CMCategory -NewName "NewCategory03"

Esse comando obtém o objeto de categoria denominado Category03 do tipo BaselineCategories e usa o operador de pipeline para passar o objeto para Rename-CMCategory, que renomeia a categoria para NewCategory03.

Parâmetros

-CategoryType

Especifica um tipo de categoria. Os valores válidos são:

  • AppCategories
  • BaselineCategories
  • CatalogCategories
  • DriverCategories
  • UserCategories
Type:CategoryType
Accepted values:AppCategories, BaselineCategories, CatalogCategories, DriverCategories, UserCategories
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

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

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
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, use o cmdlet Get-CMCategory .

Type:IResultObject
Aliases:Category
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Especifica o nome de uma instância de categoria.

Type:String
Aliases:LocalizedCategoryInstanceName, CategoryName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:True

-NewName

Especifica um novo nome para a instância de categoria.

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

-PassThru

Adicione esse parâmetro para retornar um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet pode não gerar nenhuma saída.

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

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object