Share via

Remove-CMConfigurationItem

  • 참조
모듈:
ConfigurationManager

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

Syntax

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을 실행하기 전에 확인 메시지를 표시합니다.

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

-Force

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

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

-Id

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

Type:Int32
Aliases:CIId, CI_ID
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

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

Type:IResultObject
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:String
Aliases:LocalizedDisplayName
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:True

-WhatIf

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

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