共用方式為

Remove-CMConfigurationItem

  • 參考
模組:
ConfigurationManager

從 Configuration Manager 移除設定專案。

語法

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

Description

Remove-CMConfigurationItem Cmdlet 會從 Configuration Manager 移除指定的設定專案。 您可以依識別碼、名稱或使用 Cmdlet 來指定專案。

設定專案包含一或多個設定，以及合規性規則。 專案通常會定義您想要設定的單位。

如果您移除已部署至集合的設定專案，也會移除部署。

如需設定專案的詳細資訊，請參閱 Configuration Manager 中的合規性設定簡介。

注意事項

從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet，例如 PS XYZ:\>。 如需詳細資訊，請 參閱開始使用。

範例

範例 1：使用標識碼移除專案

PS XYZ:\> Remove-CMConfigurationItem -Id "16777568"

此命令會移除具有指定標識符的組態專案。

範例 2：使用名稱移除專案

PS XYZ:\> Remove-CMConfigurationItem -Name "ConfigItem76"

此命令會移除名為 ConfigItem76 的設定專案。

範例 3：使用變數移除專案

PS XYZ:\> $CIObj=Get-CMConfigurationItem -Id "16777568"
PS XYZ:\> Remove-CMConfigurationItem -InputObject $CIObj

第一個命令會取得具有指定標識符的組態專案，並將它儲存在$CIObj變數中。

第二個命令會移除儲存在$CIObj變數中的專案。

參數

-Confirm

執行 Cmdlet 之前提示您確認。

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

-DisableWildcardHandling

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

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

-Force

強制命令在不要求使用者確認的情況下執行。

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

-ForceWildcardHandling

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

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

-Id

指定一或多個設定項目的識別碼數位。 您可以使用逗號分隔清單。

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

-InputObject

指定組態項目物件。 若要取得設定項目物件，您可以使用 Get-CMConfigurationItem Cmdlet。

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

-Name

指定組態項目的名稱陣列。

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

-WhatIf

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

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

輸入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

輸出

System.Object