共用方式為

Set-CMConfigurationItem

  • 參考
模組:
ConfigurationManager

變更 Configuration Manager 組態項目的設定。

語法

Set-CMConfigurationItem
   [-AddCategory <String[]>]
   [-Description <String>]
   [-Digest <ConfigurationItem>]
   [-DigestPath <String>]
   [-DigestXml <String>]
   [-Id] <Int32>
   [-NewName <String>]
   [-PassThru]
   [-RemoveCategory <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMConfigurationItem
   [-AddCategory <String[]>]
   [-Description <String>]
   [-Digest <ConfigurationItem>]
   [-DigestPath <String>]
   [-DigestXml <String>]
   [-Name] <String>
   [-NewName <String>]
   [-PassThru]
   [-RemoveCategory <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMConfigurationItem
   [-AddCategory <String[]>]
   [-Description <String>]
   [-Digest <ConfigurationItem>]
   [-DigestPath <String>]
   [-DigestXml <String>]
   [-InputObject] <IResultObject>
   [-NewName <String>]
   [-PassThru]
   [-RemoveCategory <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Set-CMConfigurationItem Cmdlet 會變更 Configuration Manager 組態項目的設定。

設定專案包含一或多個設定，以及合規性規則。 專案通常會定義您想要監視的設定單位。 如需設定專案的詳細資訊，請參閱 Configuration Manager 中的合規性設定簡介。

注意事項

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

範例

範例 1：變更組態項目的名稱

PS XYZ:\> Set-CMConfigurationItem -Name "CITest" -NewName "CITest01"

此命令會將名為 CITest 的設定專案名稱變更為 CITest01。

範例 2：設定項目設定

PS XYZ:\> Set-CMConfigurationItem -Name "CITest01" -SecurityScopeAction AddMembership -SecurityScopeName "DefaultScope"

此命令會將名為 CITest01 之專案的安全性範圍動作設定為 AddMembership，並將安全性範圍名稱設定為 DefaultScope。

範例 3：變更項目設定

PS XYZ:\> Set-CMConfigurationItem -Name "CITest01" -SecurityScopeAction RemoveMembership -SecurityScopeName "DefaultScope"

此命令會將名為 CITest01 之專案的安全性範圍動作設定為 RemoveMembership，並將安全性範圍名稱設定為 DefaultScope。

參數

-AddCategory

指定組態專案所屬類別的當地語系化名稱數位。

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

-Confirm

執行 Cmdlet 之前提示您確認。

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

-Description

指定組態專案的描述。

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

-Digest

指定包含組態專案的摘要。

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

-DigestPath

指定摘要的路徑。

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

-DigestXml

指定 XML 定義。

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

-DisableWildcardHandling

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

類型: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
接受萬用字元:False

-NewName

指定組態專案的新名稱。

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

-PassThru

傳回目前的工作物件。 根據預設，這個 Cmdlet 不會產生任何輸出。

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

-RemoveCategory

指定要從中移除組態專案的當地語系化類別名稱陣列。

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

-WhatIf

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

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

輸入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

輸出

System.Object