Share via

Rename-CMCategory

  • リファレンス
モジュール:
ConfigurationManager

カテゴリの名前を変更します。

構文

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

説明

Rename-CMCategory コマンドレットは、カテゴリ インスタンスの名前を変更します。

注:

Configuration Manager サイト ドライブからConfiguration Managerコマンドレットを実行します (例: PS XYZ:\>)。 詳細については、「作業の 開始」を参照してください。

例

例 1: category オブジェクトを取得してカテゴリの名前を変更する

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

最初のコマンドは、BaselineCategories 型の Category01 という名前のカテゴリ オブジェクトを取得し、オブジェクトを $Category 変数に格納します。

2 番目のコマンドは、$Categoryに格納されているカテゴリの名前を NewCategory01 に変更します。

例 2: 名前と型でカテゴリの名前を変更する

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

このコマンドは、BaseineCategories 型の Category02 という名前のカテゴリの名前を NewCategory02 に変更します。

例 3: パイプラインを通じて category オブジェクトを渡してカテゴリの名前を変更する

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

このコマンドは、BaselineCategories 型の Category03 という名前のカテゴリ オブジェクトを取得し、パイプライン演算子を使用して、オブジェクトを Rename-CMCategory に渡し、カテゴリの名前を NewCategory03 に変更します。

パラメーター

-CategoryType

カテゴリの種類を指定します。 有効な値は次のとおりです。

  • 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

コマンドレットを実行する前に確認メッセージを表示します。

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

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

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

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

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

-InputObject

カテゴリ インスタンス オブジェクトを指定します。 カテゴリ インスタンス オブジェクトを取得するには、 Get-CMCategory コマンドレットを 使用します。

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

-Name

カテゴリ インスタンスの名前を指定します。

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

-NewName

カテゴリ インスタンスの新しい名前を指定します。

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

-PassThru

このパラメーターを追加して、作業中のアイテムを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しない場合があります。

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

-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object