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

Get-CMConfigurationItem

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

Возвращает элементы конфигурации Configuration Manager.

Синтаксис

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

Описание

Командлет Get-CMConfigurationItem получает объекты элементов конфигурации в Configuration Manager. Этот командлет можно использовать для получения элементов для других командлетов. Например, вы можете получить элементы конфигурации, чтобы использовать Set-CMConfigurationItem для изменения параметров.

Элементы конфигурации содержат один или несколько параметров, а также правила соответствия. Дополнительные сведения об элементах конфигурации см. в статье Общие сведения о параметрах соответствия в Configuration Manager.

Примечание.

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

Примеры

Пример 1. Получение элемента с помощью имени

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

Эта команда возвращает элемент конфигурации с именем ConfigItem76.

Пример 2. Получение элемента для использования с другим командлетом

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

Первая команда получает элемент конфигурации с указанным идентификатором и сохраняет его в переменной $CIObj.

Вторая команда удаляет элемент из переменной $CIObj.

Параметры

-DisableWildcardHandling

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

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

-Fast

Указывает, что командлет не обновляет отложенные свойства автоматически.

Отложенные свойства содержат значения, которые относительно неэффективны для получения, что может привести к дополнительному сетевому трафику и снижению производительности командлетов. Если отложенные свойства не требуются, следует указать этот параметр.

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

-ForceWildcardHandling

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

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

-Id

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

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

-Name

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

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

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

None

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

IResultObject[]

IResultObject