Remove-CMBaseline

  • リファレンス
モジュール:
ConfigurationManager

構成基準を削除します。

構文

Remove-CMBaseline
      [-Force]
      [-Id] <Int32>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMBaseline
      [-Force]
      [-InputObject] <IResultObject>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMBaseline
      [-Force]
      [-Name] <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

構成基準を削除するには、このコマンドレットを使用します。 構成基準を削除する前に、それに対するすべての参照を削除します。

構成基準を削除した後、Configuration Managerは展開したデバイスのコレクションから構成基準を削除し、構成基準への準拠を評価Configuration Manager。

注:

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

例

例 1: 構成基準を名前で削除する

このコマンドは、 BLConfigContoso02 という名前の構成基準を削除します。 コマンドを実行する前に、確認を求めるメッセージが表示されます。

Remove-CMBaseline -Name "BLConfigContoso02"

例 2: 依存ベースラインを削除する

この例では、まず、構成基準を構成データとして アカウンティング部門のベースラインから削除します。 次に、ID 16777366を持つベースラインを削除します。 Force パラメーターは指定されているため、確認なしで実行されます。

$id = "16777366"
Set-CMBaseline -Name "Accounting department baseline" -RemoveBaseline $id
Remove-CMBaseline -Id $id -Force

依存ベースラインから構成データとしてベースラインを最初に削除しない場合、このコマンドレットは次のエラーを返します。 The configuration item cannot be deleted because there are dependent items in use.

パラメーター

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
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

-Force

ユーザーの確認を求めずにコマンドを強制的に実行します。

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:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

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

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

-Name

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

Type:String
Aliases:LocalizedDisplayName
Position:0
Default value:None
Required:True
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