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>]
说明
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 的移动设备创建配置MD_Config88。
参数
-Category
指定配置项所属的类别的本地化名称数组。
Type: | String[] |
Aliases: | LocalizedCategoryInstanceNames |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
提示你在运行 cmdlet 之前进行确认。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CreationType
指定配置项的类型。 此参数可接受的值为:
- MacOS
- MobileDevice
- 无
- WindowsApplication
- WindowsOS
Type: | CICreationType |
Accepted values: | None, WindowsApplication, WindowsOS, MacOS, MobileDevice |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
此参数将通配符视为文字字符值。 不能将其与 ForceWildcardHandling 结合使用。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
此参数处理通配符,并且可能会导致意外行为 (不建议) 。 不能将其与 DisableWildcardHandling 结合使用。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ParentConfigurationItem
指定父 CMConfigurationItem 对象。 若要获取 CMConfigurationItem 对象,请使用 Get-CMConfigurationItem cmdlet。
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
显示在 cmdlet 运行时发生的情况。 此 cmdlet 未运行。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-名称
指定配置项的名称。
Type: | String |
Aliases: | LocalizedDisplayName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-描述
指定配置项的说明。
Type: | String |
Aliases: | LocalizedDescription |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
输入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
输出
IResultObject