Share via


Set-CMBaseline

구성 기준의 설정을 변경합니다.

Syntax

Set-CMBaseline
   [-AddBaseline <String[]>]
   [-AddCategory <String[]>]
   [-AddOptionalConfigurationItem <String[]>]
   [-AddOSConfigurationItem <String[]>]
   [-AddProhibitedConfigurationItem <String[]>]
   [-AddRequiredConfigurationItem <String[]>]
   [-AddSoftwareUpdate <String[]>]
   [-AllowComanagedClients <Boolean>]
   [-ClearBaseline]
   [-ClearOptionalConfigurationItem]
   [-ClearOSConfigurationItem]
   [-ClearProhibitedConfigurationItem]
   [-ClearRequiredConfigurationItem]
   [-ClearSoftwareUpdate]
   [-Description <String>]
   [-DesiredConfigurationDigestPath <String>]
   -Id <Int32>
   [-NewName <String>]
   [-PassThru]
   [-RemoveBaseline <String[]>]
   [-RemoveCategory <String[]>]
   [-RemoveOptionalConfigurationItem <String[]>]
   [-RemoveOSConfigurationItem <String[]>]
   [-RemoveProhibitedConfigurationItem <String[]>]
   [-RemoveRequiredConfigurationItem <String[]>]
   [-RemoveSoftwareUpdate <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMBaseline
   [-AddBaseline <String[]>]
   [-AddCategory <String[]>]
   [-AddOptionalConfigurationItem <String[]>]
   [-AddOSConfigurationItem <String[]>]
   [-AddProhibitedConfigurationItem <String[]>]
   [-AddRequiredConfigurationItem <String[]>]
   [-AddSoftwareUpdate <String[]>]
   [-AllowComanagedClients <Boolean>]
   [-ClearBaseline]
   [-ClearOptionalConfigurationItem]
   [-ClearOSConfigurationItem]
   [-ClearProhibitedConfigurationItem]
   [-ClearRequiredConfigurationItem]
   [-ClearSoftwareUpdate]
   [-Description <String>]
   [-DesiredConfigurationDigestPath <String>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-RemoveBaseline <String[]>]
   [-RemoveCategory <String[]>]
   [-RemoveOptionalConfigurationItem <String[]>]
   [-RemoveOSConfigurationItem <String[]>]
   [-RemoveProhibitedConfigurationItem <String[]>]
   [-RemoveRequiredConfigurationItem <String[]>]
   [-RemoveSoftwareUpdate <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMBaseline
   [-AddBaseline <String[]>]
   [-AddCategory <String[]>]
   [-AddOptionalConfigurationItem <String[]>]
   [-AddOSConfigurationItem <String[]>]
   [-AddProhibitedConfigurationItem <String[]>]
   [-AddRequiredConfigurationItem <String[]>]
   [-AddSoftwareUpdate <String[]>]
   [-AllowComanagedClients <Boolean>]
   [-ClearBaseline]
   [-ClearOptionalConfigurationItem]
   [-ClearOSConfigurationItem]
   [-ClearProhibitedConfigurationItem]
   [-ClearRequiredConfigurationItem]
   [-ClearSoftwareUpdate]
   [-Description <String>]
   [-DesiredConfigurationDigestPath <String>]
   -InputObject <IResultObject>
   [-NewName <String>]
   [-PassThru]
   [-RemoveBaseline <String[]>]
   [-RemoveCategory <String[]>]
   [-RemoveOptionalConfigurationItem <String[]>]
   [-RemoveOSConfigurationItem <String[]>]
   [-RemoveProhibitedConfigurationItem <String[]>]
   [-RemoveRequiredConfigurationItem <String[]>]
   [-RemoveSoftwareUpdate <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

이 cmdlet을 사용하여 Configuration Manager 구성 기준 설정을 변경합니다. 구성 기준에는 다음과 같은 유형의 구성 데이터가 포함될 수 있습니다.

  • 구성 항목
  • 기타 구성 기준
  • 소프트웨어 업데이트

Configuration Manager 클라이언트는 이 기준에 대해 규정 준수를 평가합니다. 지정된 모든 항목이 규정을 준수하는 경우 기준 자체는 규격으로 평가됩니다. 디바이스에 관련 애플리케이션 또는 설정이 있는 경우에만 평가되는 선택적 항목을 포함할 수도 있습니다.

자세한 내용은 Configuration Manager 구성 기준 만들기를 참조하세요.

참고

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

예제

예제 1: 구성 기준 구성

이 예제에서는 먼저 Get-CMConfigurationItem cmdlet을 사용하여 일련의 CI(구성 항목)를 가져옵니다.

그런 다음 cmdlet 매개 변수를 매개 변수 변수에 배치합니다. 매개 변수를 스플랫할 필요는 없습니다. 이렇게 긴 명령줄에 대한 매개 변수를 더 쉽게 읽을 수 있습니다.

마지막 명령은 새 이름과 설명을 사용하여 PSTestBaseLine 기준을 구성하고, 범주를 제거하고, CI를 추가합니다.

$objPSTestWinAppCI = Get-CMConfigurationItem -Name PSTestWinAppCI
$objPSTestWinAppCI2 = Get-CMConfigurationItem -Name PSTestWinAppCI2
$objPSTestWinOSCI = Get-CMConfigurationItem -Name PSTestWinOSCI
$objPSTestWinAppCI3 = Get-CMConfigurationItem -Name PSTestWinAppCI3
$objPSTestWinAppCI4 = Get-CMConfigurationItem -Name PSTestWinAppCI4
$objPSTestMDCI = Get-CMConfigurationItem -Name PSTestMDCI
$objPSTestMacCI = Get-CMConfigurationItem -Name PSTestMacCI

$parameters = @{
  Name = "PSTestBaseLine"
  NewName = "PSTestBaseLineNew"
  Description = "DCM Testing New"
  RemoveCategory = ("IT Infrastructure")
  AddRequiredConfigurationItems = ($objPSTestWinAppCI4.CI_ID,$objPSTestMDCI.CI_ID)
  AddProhibitedConfigurationItems = ($objPSTestWinAppCI.CI_ID)
  AddOSConfigurationItems = ($objPSTestWinOSCI.CI_ID,$objPSTestMacCI.CI_ID)
  AddOptionalConfigurationItems = ($objPSTestWinAppCI2.CI_ID,$objPSTestWinAppCI3.CI_ID)
}

Set-CMBaseline @parameters

예제 2: 사용자 지정 범주 추가

이 예제에서는 먼저 New-CMCategory cmdlet을 사용하여 사용자 지정 기준 범주 Accounting을 만듭니다. 그런 다음 새 범주를 추가하도록 회계 기준을 구성합니다.

$category = New-CMCategory -CategoryType BaselineCategories -Name "Accounting"
Set-CMBaseline -Name "Accounting baseline" -AddCategory $category.LocalizedCategoryInstanceName

매개 변수

-AddBaseline

대상 기준에 구성 데이터로 추가할 기준 ID 배열을 지정합니다. 이 값은 기준선의 CI_ID 속성입니다(예: 16777516).

Type:String[]
Aliases:AddBaselines
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AddCategory

구성 기준에 추가할 구성 범주 이름의 배열을 지정합니다. 이러한 범주는 검색 및 필터링을 개선합니다. 기본적으로 사이트에는 구성 기준에 대한 다음 범주가 포함됩니다.

  • 클라이언트
  • IT 인프라
  • LOB(기간 업무)
  • 서버

다른 범주를 사용하려면 먼저 New-CMCategory cmdlet 및 매개 변수를 -CategoryType BaselineCategories 사용하여 추가합니다.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AddOptionalConfigurationItem

선택적 용도로 추가할 구성 항목 ID의 배열을 지정합니다. Configuration Manager 클라이언트는 관련 애플리케이션이 디바이스에 있는 경우에만 선택적 항목을 평가합니다.

이 값은 구성 항목의 CI_ID 속성입니다(예: 16777514).

Type:String[]
Aliases:AddOptionalConfigurationItems
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AddOSConfigurationItem

OS 형식을 추가할 구성 항목 ID 배열을 지정 합니다. 이 값은 구성 항목의 CI_ID 속성입니다(예: 16777514).

Type:String[]
Aliases:AddOSConfigurationItems
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AddProhibitedConfigurationItem

금지된 용도로 추가할 구성 항목 ID의 배열을 지정합니다. 이 값은 구성 항목의 CI_ID 속성입니다(예: 16777514).

Type:String[]
Aliases:AddProhibitedConfigurationItems
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AddRequiredConfigurationItem

필요한 용도로 추가할 구성 항목 ID의 배열을 지정 합니다 . 이 값은 구성 항목의 CI_ID 속성입니다(예: 16777514).

Type:String[]
Aliases:AddRequiredConfigurationItems
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AddSoftwareUpdate

추가할 소프트웨어 업데이트 ID 배열을 지정합니다.

Type:String[]
Aliases:AddSoftwareUpdates
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowComanagedClients

공동 관리형 클라이언트에 대해서도 항상 이 기준을 적용하려면 이 매개 변수 $true 를 로 설정합니다.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ClearBaseline

이 매개 변수를 추가하여 모든 기준을 대상 기준에서 평가 조건으로 제거합니다. 개별 기준을 제거하려면 RemoveBaseline 매개 변수를 사용합니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ClearOptionalConfigurationItem

이 매개 변수를 추가하여 모든 선택적 구성 항목을 대상 기준에서 평가 조건으로 제거합니다. 개별 선택적 CI를 제거하려면 RemoveOptionalConfigurationItem 매개 변수를 사용합니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ClearOSConfigurationItem

이 매개 변수를 추가하여 모든 OS 구성 항목을 대상 기준에서 평가 조건으로 제거합니다. 개별 OS CI를 제거하려면 RemoveOSConfigurationItem 매개 변수를 사용합니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ClearProhibitedConfigurationItem

이 매개 변수를 추가하여 금지된 모든 구성 항목을 대상 기준에서 평가 조건으로 제거합니다. 금지된 개별 CI를 제거하려면 RemoveProhibitedConfigurationItem 매개 변수를 사용합니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ClearRequiredConfigurationItem

이 매개 변수를 추가하여 필요한 모든 구성 항목을 대상 기준에서 평가 조건으로 제거합니다. 개별 필수 CI를 제거하려면 RemoveRequiredConfigurationItem 매개 변수를 사용합니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ClearSoftwareUpdate

이 매개 변수를 추가하여 모든 소프트웨어 업데이트를 대상 기준에서 평가 조건으로 제거합니다. 개별 소프트웨어 업데이트를 제거하려면 RemoveSoftwareUpdate 매개 변수를 사용합니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

구성 기준을 식별하는 데 도움이 되는 선택적 설명을 지정합니다.

Type:String
Aliases:LocalizedDescription
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DesiredConfigurationDigestPath

XML 다이제스트로 저장된 구성 데이터의 경로를 지정합니다.

Type:String
Position:Named
Default value:None
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

-ForceWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

구성할 구성 기준의 CI_ID 지정합니다. 예를 들면 16777516와 같습니다.

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

-InputObject

구성할 구성 기준 개체를 지정합니다. 이 개체를 얻으려면 Get-CMBaseline cmdlet을 사용합니다.

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

-Name

구성할 구성 기준의 이름을 지정합니다.

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

-NewName

구성 기준의 새 이름을 지정합니다. 이 매개 변수를 사용하여 대상 기준의 이름을 바꿉니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

작업 중인 항목을 나타내는 개체를 반환하려면 이 매개 변수를 추가합니다. 기본적으로 이 cmdlet은 출력을 생성하지 않을 수 있습니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemoveBaseline

대상 기준에서 구성 데이터로 제거할 기준 ID 배열을 지정합니다. 이 값은 기준선의 CI_ID 속성입니다(예: 16777516). 이 기준에서 구성 데이터로 모든 기준을 제거하려면 ClearBaseline 매개 변수를 사용합니다.

Type:String[]
Aliases:RemoveBaselines
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemoveCategory

구성 기준에서 제거할 구성 범주 이름의 배열을 지정합니다.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemoveOptionalConfigurationItem

대상 기준에서 구성 데이터로 제거할 선택적 CI ID 배열을 지정합니다. 이 값은 구성 항목의 CI_ID 속성입니다(예: 16777514). 이 기준에서 모든 선택적 구성 항목을 제거하려면 ClearOptionalConfigurationItem 매개 변수를 사용합니다.

Type:String[]
Aliases:RemoveOptionalConfigurationItems
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemoveOSConfigurationItem

대상 기준에서 구성 데이터로 제거할 OS CI ID 배열을 지정합니다. 이 값은 구성 항목의 CI_ID 속성입니다(예: 16777514). 이 기준에서 모든 OS 구성 항목을 제거하려면 ClearOSConfigurationItem 매개 변수를 사용합니다.

Type:String[]
Aliases:RemoveOSConfigurationItems
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemoveProhibitedConfigurationItem

대상 기준에서 구성 데이터로 제거할 금지된 CI ID 배열을 지정합니다. 이 값은 구성 항목의 CI_ID 속성입니다(예: 16777514). 이 기준에서 금지된 모든 구성 항목을 제거하려면 ClearProhibitedConfigurationItem 매개 변수를 사용합니다.

Type:String[]
Aliases:RemoveProhibitedConfigurationItems
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemoveRequiredConfigurationItem

대상 기준에서 구성 데이터로 제거할 필수 CI ID 배열을 지정합니다. 이 값은 구성 항목의 CI_ID 속성입니다(예: 16777514). 이 기준에서 필요한 구성 항목을 모두 제거하려면 ClearRequiredConfigurationItem 매개 변수를 사용합니다.

Type:String[]
Aliases:RemoveRequiredConfigurationItems
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemoveSoftwareUpdate

대상 기준에서 구성 데이터로 제거할 소프트웨어 업데이트 ID 배열을 지정합니다. 이 기준에서 모든 소프트웨어 업데이트를 제거하려면 ClearSoftwareUpdate 매개 변수를 사용합니다.

Type:String[]
Aliases:RemoveSoftwareUpdates
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-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