다음을 통해 공유

Remove-CMConfigurationItem

  • 참조
모듈:
ConfigurationManager

Configuration Manager에서 구성 항목을 제거합니다.

구문

Remove-CMConfigurationItem
      [-Force]
      [-Id] <Int32>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMConfigurationItem
      [-Force]
      [-InputObject] <IResultObject>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMConfigurationItem
      [-Force]
      [-Name] <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Remove-CMConfigurationItem cmdlet은 Configuration Manager에서 지정된 구성 항목을 제거합니다. ID, 이름 또는 cmdlet을 사용하여 항목을 지정할 수 있습니다.

구성 항목에는 준수 규칙과 함께 하나 이상의 설정이 포함됩니다. 항목은 일반적으로 원하는 구성 단위를 정의합니다.

컬렉션에 배포된 구성 항목을 제거하면 배포도 제거됩니다.

구성 항목에 대한 자세한 내용은 Configuration Manager의 규정 준수 설정 소개를 참조하세요.

참고

Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\>). 자세한 내용은 시작을 참조하세요.

예제

예제 1: ID를 사용하여 항목 제거

PS XYZ:\> Remove-CMConfigurationItem -Id "16777568"

이 명령은 지정된 식별자가 있는 구성 항목을 제거합니다.

예제 2: 이름을 사용하여 항목 제거

PS XYZ:\> Remove-CMConfigurationItem -Name "ConfigItem76"

이 명령은 ConfigItem76이라는 구성 항목을 제거합니다.

예제 3: 변수를 사용하여 항목 제거

PS XYZ:\> $CIObj=Get-CMConfigurationItem -Id "16777568"
PS XYZ:\> Remove-CMConfigurationItem -InputObject $CIObj

첫 번째 명령은 지정된 식별자가 있는 구성 항목을 가져오고 $CIObj 변수에 저장합니다.

두 번째 명령은 $CIObj 변수에 저장된 항목을 제거합니다.

매개 변수

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

형식:SwitchParameter
별칭:cf
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DisableWildcardHandling

이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과 결합할 수 없습니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Force

사용자 확인을 요청하지 않고 명령을 강제로 실행합니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ForceWildcardHandling

이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. DisableWildcardHandling과 결합할 수 없습니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Id

하나 이상의 구성 항목에 대한 식별자 배열을 지정합니다. 쉼표로 구분된 목록을 사용할 수 있습니다.

형식:Int32
별칭:CIId, CI_ID
Position:0
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-InputObject

구성 항목 개체를 지정합니다. 구성 항목 개체를 가져오려면 Get-CMConfigurationItem cmdlet을 사용할 수 있습니다.

형식:IResultObject
Position:0
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Name

구성 항목의 이름 배열을 지정합니다.

형식:String
별칭:LocalizedDisplayName
Position:0
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:True

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여줍니다. cmdlet이 실행되지 않습니다.

형식:SwitchParameter
별칭:wi
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

출력

System.Object