Freigeben über

Rename-CMCategory

  • Referenz
Modul:
ConfigurationManager

Benennt eine Kategorie um.

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

Beschreibung

Das Cmdlet Rename-CMCategory benennt eine Kategorieinstanz um.

Hinweis

Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Umbenennen einer Kategorie durch Abrufen eines Kategorieobjekts

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

Der erste Befehl ruft das Kategorieobjekt Category01 des Typs BaselineCategories ab und speichert das Objekt in der variablen $Category.

Der zweite Befehl benennt die in $Category gespeicherte Kategorie in NewCategory01 um.

Beispiel 2: Umbenennen einer Kategorie nach Name und Typ

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

Dieser Befehl benennt die Kategorie Category02 des Typs BaseineCategories in NewCategory02 um.

Beispiel 3: Umbenennen einer Kategorie durch Übergeben eines Kategorieobjekts durch die Pipeline

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

Dieser Befehl ruft das Kategorieobjekt Category03 des Typs BaselineCategories ab und verwendet den Pipelineoperator, um das Objekt an Rename-CMCategory zu übergeben, wodurch die Kategorie in NewCategory03 umbenannt wird.

Parameter

-CategoryType

Gibt einen Kategorietyp an. Gültige Werte sind:

  • App-Kategorien
  • BaselineCategories
  • CatalogCategories
  • DriverCategories
  • UserCategories
Typ:CategoryType
Zulässige Werte:AppCategories, BaselineCategories, CatalogCategories, DriverCategories, UserCategories
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Gibt ein Kategorieinstanzobjekt an. Verwenden Sie zum Abrufen eines Kategorieinstanzobjekts das Cmdlet Get-CMCategory .

Typ:IResultObject
Aliase:Category
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen einer Kategorieinstanz an.

Typ:String
Aliase:LocalizedCategoryInstanceName, CategoryName
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-NewName

Gibt einen neuen Namen für die Kategorieinstanz an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PassThru

Fügen Sie diesen Parameter hinzu, um ein Objekt zurückzugeben, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig generiert dieses Cmdlet möglicherweise keine Ausgabe.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object