共用方式為

Get-CMConfigurationItem

  • 參考
模組:
ConfigurationManager

取得 Configuration Manager 設定專案。

語法

Get-CMConfigurationItem
   [-Fast]
   [[-Name] <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMConfigurationItem
   [-Fast]
   [-Id] <Int32>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Get-CMConfigurationItem Cmdlet 會取得 Configuration Manager 中的設定項目物件。 您可以使用此 Cmdlet 來取得其他 Cmdlet 要使用的專案。 例如，您可能會取得設定專案，以便使用 Set-CMConfigurationItem 來變更其設定。

設定專案包含一或多個設定，以及合規性規則。 如需設定專案的詳細資訊，請參閱 Configuration Manager 中的合規性設定簡介。

注意事項

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

範例

範例 1：使用名稱取得專案

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

此命令會取得名為 ConfigItem76 的組態專案。

範例 2：取得要與另一個 Cmdlet 搭配使用的專案

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

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

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

參數

-DisableWildcardHandling

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

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

-Fast

表示 Cmdlet 不會自動重新整理延遲屬性。

延遲屬性包含相對沒有效率的擷取值，這可能會導致額外的網路流量並降低 Cmdlet 效能。 如果不需要延遲屬性，則應該指定此參數。

類型: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

-Name

指定組態項目的名稱陣列。 您可以使用逗號分隔清單。

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

輸入

None

輸出

IResultObject[]

IResultObject