Set-CMBaseline

模組:

ConfigurationManager

變更組態基準的設定。

語法

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 來取得一系列設定專案， (CIS) 。

然後，它會將 Cmdlet 參數展開至 parameters 變數。 不一定需要套用參數，只要讓您更輕鬆地讀取這麼長命令行的參數即可。

最後一個命令會使用新的名稱和描述來設定 PSTestBaseLine 基準、移除類別，並新增 CIS。

$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

指定要新增為設定數據至目標基準的基準標識子陣列。 這個值是基準的CI_ID屬性，例如 。 16777516

類型:	String[]
別名:	AddBaselines
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AddCategory

指定要新增至組態基準的組態類別名稱陣列。 這些類別可改善搜尋和篩選。 根據預設，月臺包含下列設定基準類別：

• 用戶端
• IT 基礎結構
• 企業營運
• 伺服器

若要使用另一個類別，請先使用 New-CMCategory Cmdlet 和 -CategoryType BaselineCategories 參數加以新增。

類型:	String[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AddOptionalConfigurationItem

指定要以 選擇性 用途新增的組態專案標識子陣列。 如果裝置上有相關的應用程式，Configuration Manager 用戶端只會評估選擇性專案。

這個值是組態項目的CI_ID屬性，例如 16777514

類型:	String[]
別名:	AddOptionalConfigurationItems
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AddOSConfigurationItem

指定要新增 OS 類型的組態項目識別子陣 列。 這個值是組態項目的CI_ID屬性，例如 16777514

類型:	String[]
別名:	AddOSConfigurationItems
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AddProhibitedConfigurationItem

指定組態專案標識碼的陣列，以 使用禁止 的用途加入。 這個值是組態項目的CI_ID屬性，例如 16777514

類型:	String[]
別名:	AddProhibitedConfigurationItems
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AddRequiredConfigurationItem

指定組態專案標識碼的陣列，以 必要目的新增 。 這個值是組態項目的CI_ID屬性，例如 16777514

類型:	String[]
別名:	AddRequiredConfigurationItems
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AddSoftwareUpdate

指定要新增的軟體更新識別子陣列。

類型:	String[]
別名:	AddSoftwareUpdates
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AllowComanagedClients

將此參數設定為 $true ，即使共同管理的用戶端也一律套用此基準。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ClearBaseline

新增此參數，以從目標基準中移除所有基準作為評估條件。 若要移除個別的基準，請使用 RemoveBaseline 參數。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ClearOptionalConfigurationItem

新增此參數，以從目標基準中移除所有 選擇性 設定專案作為評估條件。 若要移除個別的選擇性 CIS，請使用 RemoveOptionalConfigurationItem 參數。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ClearOSConfigurationItem

新增此參數，以從目標基準中移除所有 操作系統 設定專案作為評估條件。 若要移除個別的OS CIS，請使用 RemoveOSConfigurationItem 參數。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ClearProhibitedConfigurationItem

新增此參數，以從目標基準中移除所有 禁止 的設定專案作為評估條件。 若要移除個別禁止的 CIS，請使用 RemoveProhibitedConfigurationItem 參數。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ClearRequiredConfigurationItem

新增此參數，以從目標基準中移除所有 必要的 設定專案作為評估條件。 若要移除個別的必要 CIS，請使用 RemoveRequiredConfigurationItem 參數。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ClearSoftwareUpdate

新增此參數，以從目標基準中移除所有軟體更新作為評估條件。 若要移除個別的軟體更新，請使用 RemoveSoftwareUpdate 參數。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Confirm

執行 Cmdlet 之前提示您確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Description

指定設定基準的選擇性描述，以協助識別它。

類型:	String
別名:	LocalizedDescription
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DesiredConfigurationDigestPath

指定儲存為 XML 摘要之組態資料的路徑。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DisableWildcardHandling

此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ForceWildcardHandling

此參數會處理通配符，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Id

指定要 設定之組 態基準的CI_ID。 例如，16777516。

類型:	Int32
別名:	CIId, CI_ID
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-InputObject

指定要設定的組態基準物件。 若要取得此物件，請使用 Get-CMBaseline Cmdlet 。

類型:	IResultObject
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-Name

指定要設定的組態基準名稱。

類型:	String
別名:	LocalizedDisplayName
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-NewName

指定設定基準的新名稱。 使用此參數來重新命名目標基準。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PassThru

新增此參數以傳回 物件，代表您正在使用的專案。 根據預設，此 Cmdlet 可能不會產生任何輸出。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-RemoveBaseline

指定要從目標基準中移除做為設定數據的基準標識子陣列。 這個值是基準的CI_ID屬性，例如 。 16777516 若要從此基準中移除所有基準作為設定數據，請使用 ClearBaseline 參數。

類型:	String[]
別名:	RemoveBaselines
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-RemoveCategory

指定組態類別目錄名稱的陣列，以從組態基準中移除。

類型:	String[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-RemoveOptionalConfigurationItem

指定 選擇性 CI 識別子的陣列，以從目標基準中移除為設定資料。 這個值是組態項目的CI_ID屬性，例如 16777514 若要從此基準移除所有選擇性設定專案，請使用 ClearOptionalConfigurationItem 參數。

類型:	String[]
別名:	RemoveOptionalConfigurationItems
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-RemoveOSConfigurationItem

指定要從目標基準中移除為設定資料的 OS CI識別元陣列。 這個值是組態項目的CI_ID屬性，例如 16777514 若要從此基準移除所有OS設定專案，請使用 ClearOSConfigurationItem 參數。

類型:	String[]
別名:	RemoveOSConfigurationItems
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-RemoveProhibitedConfigurationItem

指定 禁止 的 CI 識別子陣列，以從目標基準中移除作為設定資料。 這個值是組態項目的CI_ID屬性，例如 16777514 若要從此基準移除所有禁止的設定專案，請使用 ClearProhibitedConfigurationItem 參數。

類型:	String[]
別名:	RemoveProhibitedConfigurationItems
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-RemoveRequiredConfigurationItem

指定 必要的 CI 識別子陣列，以從目標基準中移除作為設定資料。 這個值是組態項目的CI_ID屬性，例如 16777514 若要從此基準移除所有必要的設定專案，請使用 ClearRequiredConfigurationItem 參數。

類型:	String[]
別名:	RemoveRequiredConfigurationItems
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-RemoveSoftwareUpdate

指定要從目標基準移除為設定資料的軟體更新標識子陣列。 若要從此基準移除所有軟體更新，請使用 ClearSoftwareUpdate 參數。

類型:	String[]
別名:	RemoveSoftwareUpdates
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

輸出

System.Object

相關連結

• Disable-CMBaseline
• Enable-CMBaseline
• Export-CMBaseline
• Get-CMBaseline
• Import-CMBaseline
• New-CMBaseline
• Remove-CMBaseline
• Get-CMBaselineXMLDefinition
• Get-CMBaselineSummarizationSchedule
• 在 Configuration Manager 中建立設定基準