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>]

説明

Configuration Manager の構成基準の設定を変更するには、このコマンドレットを使用します。 構成基準には、次の種類の構成データを含めできます。

• 構成項目
• その他の構成基準
• ソフトウェア更新プログラム

Configuration Manager クライアントは、この基準に対するコンプライアンスを評価します。 指定した項目すべてが準拠している場合、基準計画自体は準拠として評価されます。 関連するアプリケーションまたは設定がデバイスに存在する場合にのみ評価されるオプションアイテムを含めすることもできます。

詳細については 、「Configuration Manager で構成基準を作成する」を参照してください。

注意

Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\> 。 詳細については 、「Getting started」を参照してください。

例

例 1: 構成基準を構成する

この例では、 まず Get-CMConfigurationItem コマンドレットを使用して、一連の構成項目 (CIs) を取得します。

その後 、コマンドレット パラメーター を 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 コマンドレットを使用して、カスタム ベースライン カテゴリ 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
Accept pipeline input:	False
Accept wildcard characters:	False

-AddCategory

構成基準に追加する構成カテゴリ名の配列を指定します。 これらのカテゴリを使用すると、検索とフィルター処理が向上します。 既定では、構成基準に関する次のカテゴリがサイトに含まれています。

• クライアント
• IT インフラストラクチャ
• 基幹業務
• サーバー

別のカテゴリを使用するには、まず New-CMCategory コマンドレットとパラメーターを使用して追加 -CategoryType BaselineCategories します。

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

-AddOptionalConfigurationItem

オプションの目的で追加する構成項目の ID の配列を 指定 します。 Configuration Manager クライアントは、関連するアプリケーションがデバイスに存在する場合にのみ、オプション項目を評価します。

この値は 、CI_ID のプロパティです 16777514 。

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

-AddOSConfigurationItem

OS の種類を追加する構成項目の ID の配列を指定 します。 この値は 、CI_ID のプロパティです 16777514 。

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

-AddProhibitedConfigurationItem

禁止された目的で追加する構成項目の ID の配列 を指定 します。 この値は 、CI_ID のプロパティです 16777514 。

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

-AddRequiredConfigurationItem

必要な目的で追加する構成項目の ID の配列を 指定 します。 この値は 、CI_ID のプロパティです 16777514 。

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

-AddSoftwareUpdate

追加するソフトウェア更新プログラムの ID の配列を指定します。

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

-AllowComanagedClients

このパラメーターは、 $true 共同管理クライアントに対しても常にこの基準を適用する場合に設定します。

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

-ClearBaseline

このパラメーターを追加して、すべての基準計画を評価条件としてターゲット ベースラインから削除します。 個々の基準計画を削除するには 、RemoveBaseline パラメーターを使用 します。

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

-ClearOptionalConfigurationItem

このパラメーターを追加して、オプション のすべての構成項目を 評価条件としてターゲット ベースラインから削除します。 個々のオプションの CIs を削除するには 、RemoveOptionalConfigurationItem パラメーターを使用 します。

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

-ClearOSConfigurationItem

このパラメーターを追加して、 すべての OS 構成項目を評価条件としてターゲット ベースラインから削除します。 個々の OS CIs を削除するには 、RemoveOSConfigurationItem パラメーターを使用 します。

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

-ClearProhibitedConfigurationItem

このパラメーターを追加して、禁止されている構成 項目を ターゲット ベースラインから評価条件として削除します。 禁止されている個々の CIs を削除するには 、RemoveProhibitedConfigurationItem パラメーターを使用 します。

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

-ClearRequiredConfigurationItem

このパラメーターを追加して、必要 なすべての構成項目 を評価条件としてターゲット ベースラインから削除します。 個々の必須の CIs を削除するには 、RemoveRequiredConfigurationItem パラメーターを使用 します。

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

-ClearSoftwareUpdate

このパラメーターを追加して、すべてのソフトウェア更新プログラムを評価条件としてターゲット ベースラインから削除します。 個々のソフトウェア更新プログラムを削除するには 、RemoveSoftwareUpdate パラメーターを使用 します。

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

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

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

-Description

構成基準の説明 (省略可能) を指定して、構成基準を識別します。

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

-DesiredConfigurationDigestPath

XML ダイジェストとして格納される構成データへのパスを指定します。

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

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字値として扱います。 ForceWildcardHandling と組み合わせは使用できない。

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

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。

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

-Id

構成する CI_ID 基準の構成基準を指定します。 たとえば、「 16777516 」のように入力します。

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

-InputObject

構成する構成基準オブジェクトを指定します。 このオブジェクトを取得するには 、Get-CMBaseline コマンドレットを使用 します。

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

-Name

構成する構成基準の名前を指定します。

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

-NewName

構成基準の新しい名前を指定します。 このパラメーターを使用して、ターゲット ベースラインの名前を変更します。

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

-PassThru

このパラメーターを追加して、作業しているアイテムを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しない場合があります。

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

-RemoveBaseline

ターゲット ベースラインから構成データとして削除する基準計画の ID の配列を指定します。 この値 は、CI_ID のプロパティです 16777516 。 この基準計画から構成データとしてすべての基準を削除するには 、ClearBaseline パラメーターを使用 します。

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

-RemoveCategory

構成基準から削除する構成カテゴリ名の配列を指定します。

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

-RemoveOptionalConfigurationItem

ターゲット ベースラインから構成データ として 削除するオプションの CI ID の配列を指定します。 この値は 、CI_ID のプロパティです 16777514 。 この基準からすべてのオプション構成項目を削除するには 、ClearOptionalConfigurationItem パラメーターを使用 します。

Type:	String[]
Aliases:	RemoveOptionalConfigurationItems
Position:	Named
Default value:	None
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
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveProhibitedConfigurationItem

ターゲット ベースラインから構成データ として 削除する禁止 CI ID の配列を指定します。 この値は 、CI_ID のプロパティです 16777514 。 この基準から禁止されている構成項目をすべて削除するには 、ClearProhibitedConfigurationItem パラメーターを使用 します。

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

-RemoveRequiredConfigurationItem

ターゲット ベースラインから構成データ として 削除するために必要な CI ID の配列を指定します。 この値は 、CI_ID のプロパティです 16777514 。 この基準から必要なすべての構成項目を削除するには 、ClearRequiredConfigurationItem パラメーターを使用 します。

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

-RemoveSoftwareUpdate

ターゲット ベースラインから構成データとして削除するソフトウェア更新プログラムの ID の配列を指定します。 この基準からすべてのソフトウェア更新プログラムを削除するには 、ClearSoftwareUpdate パラメーターを使用 します。

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

-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	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 で構成基準を作成する