Rename-CMCategory
カテゴリの名前を変更します。
構文
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 コマンドレットは、カテゴリ インスタンスの名前を変更します。
注:
PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 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
| 型: | CategoryType |
| 指定可能な値: | AppCategories, BaselineCategories, CatalogCategories, DriverCategories, UserCategories |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-InputObject
カテゴリ インスタンス オブジェクトを指定します。 カテゴリ インスタンス オブジェクトを取得するには、 Get-CMCategory コマンドレットを 使用します。
| 型: | IResultObject |
| Aliases: | Category |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Name
カテゴリ インスタンスの名前を指定します。
| 型: | String |
| Aliases: | LocalizedCategoryInstanceName, CategoryName |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | True |
-NewName
カテゴリ インスタンスの新しい名前を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PassThru
このパラメーターを追加して、作業中のアイテムを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しない場合があります。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
System.Object