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>]Description
Rename-CMCategory Cmdlet 會重新命名類別實例。
注意事項
從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet，例如 PS XYZ:\>。 如需詳細資訊，請 參閱開始使用。
範例
範例 1：藉由取得類別物件來重新命名類別
PS ABC:\> $Category = Get-CMCategory -Name "Category01" -CategoryType BaselineCategories
PS ABC:\> Rename-CMCategory -InputObject $Category -NewName "NewCategory01"第一個命令會取得BaselineCategories類型的Category01類別物件，並將物件儲存在$Category變數中。
第二個命令會將儲存在 $Category 中的類別重新命名為 NewCategory01。
範例 2：依類別名稱和類型重新命名
PS ABC:\> Rename-CMCategory -Name "Category02" -NewName "NewCategory02" -CategoryType BaselineCategories此命令會將BaseineCategories類型的Category02類別重新命名為NewCategory02。
範例 3：透過管線傳遞類別物件來重新命名類別
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 |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Confirm
執行 Cmdlet 之前提示您確認。
| 類型: | SwitchParameter |
| 別名: | cf |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DisableWildcardHandling
此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ForceWildcardHandling
此參數會處理通配符，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-InputObject
指定類別實例物件。 若要取得類別實例物件，請使用 Get-CMCategory Cmdlet。
| 類型: | IResultObject |
| 別名: | Category |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Name
指定類別目錄實例的名稱。
| 類型: | String |
| 別名: | LocalizedCategoryInstanceName, CategoryName |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | True |
-NewName
指定類別實例的新名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-PassThru
新增此參數以傳回 物件，代表您正在使用的專案。 根據預設，此 Cmdlet 可能不會產生任何輸出。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。
| 類型: | SwitchParameter |
| 別名: | wi |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
輸出
System.Object