Set-CMBaseline
構成基準の設定を変更します。
構文
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:\>)。 詳細については、「作業の 開始」を参照してください。
例
例 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)。
| Type: | String[] |
| Aliases: | AddBaselines |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AddCategory
構成基準に追加する構成カテゴリ名の配列を指定します。 これらのカテゴリでは、検索とフィルター処理が向上します。 既定では、サイトには構成基準に次のカテゴリが含まれています。
- Client
- IT インフラストラクチャ
- 基幹業務
- サーバー
別のカテゴリを使用するには、まず New-CMCategory コマンドレットとパラメーターを -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
このパラメーターを追加して、 すべてのオプション の構成項目を評価条件としてターゲット ベースラインから削除します。 個々の省略可能な CA を削除するには、 RemoveOptionalConfigurationItem パラメーターを使用します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ClearOSConfigurationItem
このパラメーターを追加して、すべての OS 構成項目を評価条件としてターゲット ベースラインから削除します。 個々の OS API を削除するには、 RemoveOSConfigurationItem パラメーターを使用します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ClearProhibitedConfigurationItem
このパラメーターを追加して、 禁止されているすべての 構成項目を評価条件としてターゲット ベースラインから削除します。 禁止されている個々の API を削除するには、 RemoveProhibitedConfigurationItem パラメーターを 使用します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ClearRequiredConfigurationItem
このパラメーターを追加して、 必要なすべての 構成項目を評価条件としてターゲット ベースラインから削除します。 必要な個々の API を削除するには、 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
コマンドレットを実行する前に確認メッセージを表示します。
| 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 コマンドレットを 使用します。
| 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
このパラメーターを追加して、作業中のアイテムを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しない場合があります。
| 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
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| 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
関連リンク
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示