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 で構成基準を作成する」を参照してください。

注:

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

例

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

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

次に、コマンドレット パラメーターを parameters 変数にスプラットします。 パラメーターをスプラッタする必要はありません。これにより、このような長いコマンド ラインのパラメーターを読みやすくなります。

最後のコマンドは、新しい名前と説明を使用して PSTestBaseLine ベースラインを構成し、カテゴリを削除し、CLI を追加します。

$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 コマンドレットを使用して、カスタム ベースライン カテゴリ アカウンティングを作成します。 次に、新しいカテゴリを追加するように アカウンティング ベースライン を構成します。

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

パラメーター

-AddBaseline

ターゲット ベースラインに構成データとして追加するベースライン ID の配列を指定します。 この値は、ベースラインの CI_ID プロパティです (たとえば、 16777516)。

型:	String[]
Aliases:	AddBaselines
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AddCategory

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

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

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

型:	String[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AddOptionalConfigurationItem

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

この値は、構成項目の CI_ID プロパティです (たとえば、 16777514)。

型:	String[]
Aliases:	AddOptionalConfigurationItems
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AddOSConfigurationItem

OS 型を追加する構成項目 ID の配列を指定 します。 この値は、構成項目の CI_ID プロパティです (たとえば、 16777514)。

型:	String[]
Aliases:	AddOSConfigurationItems
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AddProhibitedConfigurationItem

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

型:	String[]
Aliases:	AddProhibitedConfigurationItems
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AddRequiredConfigurationItem

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

型:	String[]
Aliases:	AddRequiredConfigurationItems
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AddSoftwareUpdate

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

型:	String[]
Aliases:	AddSoftwareUpdates
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AllowComanagedClients

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

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ClearBaseline

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

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ClearOptionalConfigurationItem

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

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ClearOSConfigurationItem

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

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ClearProhibitedConfigurationItem

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

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ClearRequiredConfigurationItem

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

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ClearSoftwareUpdate

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

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Confirm

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

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Description

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

型:	String
Aliases:	LocalizedDescription
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DesiredConfigurationDigestPath

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DisableWildcardHandling

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

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Id

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

型:	Int32
Aliases:	CIId, CI_ID
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-InputObject

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

型:	IResultObject
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-Name

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

型:	String
Aliases:	LocalizedDisplayName
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-NewName

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PassThru

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

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RemoveBaseline

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

型:	String[]
Aliases:	RemoveBaselines
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RemoveCategory

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

型:	String[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RemoveOptionalConfigurationItem

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

型:	String[]
Aliases:	RemoveOptionalConfigurationItems
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RemoveOSConfigurationItem

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

型:	String[]
Aliases:	RemoveOSConfigurationItems
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RemoveProhibitedConfigurationItem

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

型:	String[]
Aliases:	RemoveProhibitedConfigurationItems
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RemoveRequiredConfigurationItem

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

型:	String[]
Aliases:	RemoveRequiredConfigurationItems
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RemoveSoftwareUpdate

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

型:	String[]
Aliases:	RemoveSoftwareUpdates
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WhatIf

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

型:	SwitchParameter
Aliases:	wi
配置:	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 で構成基準を作成する