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