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

Set-CMConfigurationItem

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

Изменяет параметры для элемента конфигурации Configuration Manager.

Синтаксис

Set-CMConfigurationItem
   [-AddCategory <String[]>]
   [-Description <String>]
   [-Digest <ConfigurationItem>]
   [-DigestPath <String>]
   [-DigestXml <String>]
   [-Id] <Int32>
   [-NewName <String>]
   [-PassThru]
   [-RemoveCategory <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMConfigurationItem
   [-AddCategory <String[]>]
   [-Description <String>]
   [-Digest <ConfigurationItem>]
   [-DigestPath <String>]
   [-DigestXml <String>]
   [-Name] <String>
   [-NewName <String>]
   [-PassThru]
   [-RemoveCategory <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMConfigurationItem
   [-AddCategory <String[]>]
   [-Description <String>]
   [-Digest <ConfigurationItem>]
   [-DigestPath <String>]
   [-DigestXml <String>]
   [-InputObject] <IResultObject>
   [-NewName <String>]
   [-PassThru]
   [-RemoveCategory <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Командлет Set-CMConfigurationItem изменяет параметры для элемента конфигурации Configuration Manager.

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

Примечание.

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

Примеры

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

PS XYZ:\> Set-CMConfigurationItem -Name "CITest" -NewName "CITest01"

Эта команда изменяет имя элемента конфигурации с именем CITest на CITest01.

Пример 2. Настройка параметров элемента

PS XYZ:\> Set-CMConfigurationItem -Name "CITest01" -SecurityScopeAction AddMembership -SecurityScopeName "DefaultScope"

Эта команда задает для действия области безопасности значение AddMembership, а имя области безопасности — DefaultScope для элемента с именем CITest01.

Пример 3. Изменение параметров элемента

PS XYZ:\> Set-CMConfigurationItem -Name "CITest01" -SecurityScopeAction RemoveMembership -SecurityScopeName "DefaultScope"

Эта команда задает для действия области безопасности значение RemoveMembership, а имя области безопасности — DefaultScope для элемента с именем CITest01.

Параметры

-AddCategory

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

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

-Confirm

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

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

-Description

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

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

-Digest

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

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

-DigestPath

Указывает путь к дайджесту.

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

-DigestXml

Задает определение XML.

Тип:String
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

-Id

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

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

-InputObject

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

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

-Name

Задает массив имен для элементов конфигурации.

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

-NewName

Задает новое имя для элемента конфигурации.

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

-PassThru

Возвращает текущий рабочий объект. По умолчанию данный командлет не создает каких-либо выходных результатов.

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

-RemoveCategory

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

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

-WhatIf

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

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

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

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

System.Object