New-CMConfigurationItem
建立 Configuration Manager 組態專案。
語法
New-CMConfigurationItem
[-Category <String[]>]
[-Description <String>]
-Name <String>
-ParentConfigurationItem <IResultObject>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMConfigurationItem
[-Category <String[]>]
-CreationType <CICreationType>
[-Description <String>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
New-CMConfigurationItem Cmdlet 會在 Configuration Manager 中建立設定專案。 建立設定專案，以定義您想要管理和評估裝置合規性的設定。
您可以指定 ParentConfigurationItem 參數來建立子組態專案。 Configuration Manager 中的子設定專案是保留與原始設定項目關聯性的設定項目複本;因此，它們會從父設定專案繼承原始組態。 您無法為行動裝置建立子設定專案。
注意事項
從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet，例如 PS XYZ:\>。 如需詳細資訊，請 參閱開始使用。
範例
範例 1：建立設定專案
PS XYZ:\> New-CMConfigurationItem -CreationType MobileDevice -Name "MD_Config88"此命令會為名為 MD_Config88的行動裝置建立組態專案。
參數
-Category
指定組態專案所屬類別的當地語系化名稱數位。
| 類型: | String[] |
| 別名: | LocalizedCategoryInstanceNames |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Confirm
執行 Cmdlet 之前提示您確認。
| 類型: | SwitchParameter |
| 別名: | cf |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-CreationType
指定組態項目的類型。 此參數可接受的值為：
- MacOS
- MobileDevice
- 無
- WindowsApplication
- WindowsOS
| 類型: | CICreationType |
| 接受的值: | None, WindowsApplication, WindowsOS, MacOS, MobileDevice |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Description
指定組態專案的描述。
| 類型: | String |
| 別名: | LocalizedDescription |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DisableWildcardHandling
此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ForceWildcardHandling
此參數會處理通配符，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Name
指定組態項目的名稱。
| 類型: | String |
| 別名: | LocalizedDisplayName |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ParentConfigurationItem
指定父 CMConfigurationItem 物件。 若要取得 CMConfigurationItem 物件，請使用 Get-CMConfigurationItem Cmdlet。
| 類型: | IResultObject |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 未執行 Cmdlet。
| 類型: | SwitchParameter |
| 別名: | wi |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
輸出
IResultObject