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 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
| 형식: | SwitchParameter |
| 별칭: | cf |
| Position: | Named |
| Default value: | False |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DisableWildcardHandling
이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과 결합할 수 없습니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ForceWildcardHandling
이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. DisableWildcardHandling과 결합할 수 없습니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-InputObject
범주 인스턴스 개체를 지정합니다. 범주 인스턴스 개체를 가져오려면 Get-CMCategory cmdlet을 사용합니다.
| 형식: | IResultObject |
| 별칭: | Category |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-Name
범주 인스턴스의 이름을 지정합니다.
| 형식: | String |
| 별칭: | LocalizedCategoryInstanceName, CategoryName |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | True |
-NewName
범주 인스턴스의 새 이름을 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-PassThru
작업 중인 항목을 나타내는 개체를 반환하려면 이 매개 변수를 추가합니다. 기본적으로 이 cmdlet은 출력을 생성하지 않을 수 있습니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-WhatIf
cmdlet이 실행되면 어떻게 되는지 보여줍니다. cmdlet이 실행되지 않습니다.
| 형식: | SwitchParameter |
| 별칭: | wi |
| Position: | Named |
| Default value: | False |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
입력
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
출력
System.Object