Condividi tramite

Rename-CMCategory

  • Riferimento
Modulo:
ConfigurationManager

Rinomina una categoria.

Sintassi

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>]

Descrizione

Il cmdlet Rename-CMCategory rinomina un'istanza di categoria.

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Rinominare una categoria recuperando un oggetto categoria

PS ABC:\> $Category = Get-CMCategory -Name "Category01" -CategoryType BaselineCategories
PS ABC:\> Rename-CMCategory -InputObject $Category -NewName "NewCategory01"

Il primo comando ottiene l'oggetto categoria denominato Category01 del tipo BaselineCategories e archivia l'oggetto nella variabile $Category.

Il secondo comando rinomina la categoria archiviata in $Category in NewCategory01.

Esempio 2: Rinominare una categoria in base al nome e al tipo

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

Questo comando rinomina la categoria denominata Category02 del tipo BaseineCategories in NewCategory02.

Esempio 3: Rinominare una categoria passando un oggetto categoria attraverso la pipeline

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

Questo comando ottiene l'oggetto categoria denominato Category03 del tipo BaselineCategories e usa l'operatore della pipeline per passare l'oggetto a Rename-CMCategory, che rinomina la categoria in NewCategory03.

Parametri

-CategoryType

Specifica un tipo di categoria. I valori validi sono:

  • AppCategories
  • BaselineCategories
  • CatalogCategories
  • DriverCategories
  • UserCategories
Tipo:CategoryType
Valori accettati:AppCategories, BaselineCategories, CatalogCategories, DriverCategories, UserCategories
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Specifica un oggetto istanza di categoria. Per ottenere un oggetto istanza di categoria, usare il cmdlet Get-CMCategory .

Tipo:IResultObject
Alias:Category
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Specifica il nome di un'istanza di categoria.

Tipo:String
Alias:LocalizedCategoryInstanceName, CategoryName
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

-NewName

Specifica un nuovo nome per l'istanza della categoria.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PassThru

Aggiungere questo parametro per restituire un oggetto che rappresenta l'elemento con cui si sta lavorando. Per impostazione predefinita, questo cmdlet potrebbe non generare alcun output.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object