Поделиться через

New-CMConfigurationItem

  • Ссылка
Модуль:
ConfigurationManager

Создает элемент конфигурации 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 создает элемент конфигурации в Configuration Manager. Создайте элементы конфигурации, чтобы определить конфигурации, которыми вы хотите управлять, и оценивать соответствие на устройствах.

Для создания дочернего элемента конфигурации можно указать параметр ParentConfigurationItem . Дочерние элементы конфигурации в Configuration Manager — это копии элементов конфигурации, которые сохраняют связь с исходным элементом конфигурации; таким образом, они наследуют исходную конфигурацию от родительского элемента конфигурации. Нельзя создавать дочерние элементы конфигурации для мобильных устройств.

Примечание.

Запустите командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>. Дополнительные сведения см. в статье Начало работы.

Примеры

Пример 1. Создание элемента конфигурации

PS XYZ:\> New-CMConfigurationItem -CreationType MobileDevice -Name "MD_Config88"

Эта команда создает элемент конфигурации для мобильных устройств с именем MD_Config88.

Параметры

-Category

Задает массив локализованных имен категорий, к которым принадлежит элемент конфигурации.

Тип:String[]
Aliases:LocalizedCategoryInstanceNames
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Confirm

Перед запуском командлет запросит подтверждение.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-CreationType

Указывает тип элемента конфигурации. Допустимые значения для этого параметра:

  • MacOS
  • MobileDevice
  • Нет
  • WindowsApplication
  • WindowsOS
Тип:CICreationType
Допустимые значения:None, WindowsApplication, WindowsOS, MacOS, MobileDevice
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Description

Указывает описание элемента конфигурации.

Тип:String
Aliases:LocalizedDescription
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DisableWildcardHandling

Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ForceWildcardHandling

Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Name

Указывает имя элемента конфигурации.

Тип:String
Aliases:LocalizedDisplayName
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ParentConfigurationItem

Указывает родительский объект CMConfigurationItem . Чтобы получить объект CMConfigurationItem , используйте командлет Get-CMConfigurationItem .

Тип:IResultObject
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-WhatIf

Показывает, что произойдет при запуске этого командлета. Командлет при этом не запускается.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Выходные данные

IResultObject