Set-CMBaseline

Ссылка

Модуль:: ConfigurationManager

Измените параметры базовых конфигураций.

Синтаксис

Set-CMBaseline
   [-AddBaseline <String[]>]
   [-AddCategory <String[]>]
   [-AddOptionalConfigurationItem <String[]>]
   [-AddOSConfigurationItem <String[]>]
   [-AddProhibitedConfigurationItem <String[]>]
   [-AddRequiredConfigurationItem <String[]>]
   [-AddSoftwareUpdate <String[]>]
   [-AllowComanagedClients <Boolean>]
   [-ClearBaseline]
   [-ClearOptionalConfigurationItem]
   [-ClearOSConfigurationItem]
   [-ClearProhibitedConfigurationItem]
   [-ClearRequiredConfigurationItem]
   [-ClearSoftwareUpdate]
   [-Description <String>]
   [-DesiredConfigurationDigestPath <String>]
   -Id <Int32>
   [-NewName <String>]
   [-PassThru]
   [-RemoveBaseline <String[]>]
   [-RemoveCategory <String[]>]
   [-RemoveOptionalConfigurationItem <String[]>]
   [-RemoveOSConfigurationItem <String[]>]
   [-RemoveProhibitedConfigurationItem <String[]>]
   [-RemoveRequiredConfigurationItem <String[]>]
   [-RemoveSoftwareUpdate <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMBaseline
   [-AddBaseline <String[]>]
   [-AddCategory <String[]>]
   [-AddOptionalConfigurationItem <String[]>]
   [-AddOSConfigurationItem <String[]>]
   [-AddProhibitedConfigurationItem <String[]>]
   [-AddRequiredConfigurationItem <String[]>]
   [-AddSoftwareUpdate <String[]>]
   [-AllowComanagedClients <Boolean>]
   [-ClearBaseline]
   [-ClearOptionalConfigurationItem]
   [-ClearOSConfigurationItem]
   [-ClearProhibitedConfigurationItem]
   [-ClearRequiredConfigurationItem]
   [-ClearSoftwareUpdate]
   [-Description <String>]
   [-DesiredConfigurationDigestPath <String>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-RemoveBaseline <String[]>]
   [-RemoveCategory <String[]>]
   [-RemoveOptionalConfigurationItem <String[]>]
   [-RemoveOSConfigurationItem <String[]>]
   [-RemoveProhibitedConfigurationItem <String[]>]
   [-RemoveRequiredConfigurationItem <String[]>]
   [-RemoveSoftwareUpdate <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMBaseline
   [-AddBaseline <String[]>]
   [-AddCategory <String[]>]
   [-AddOptionalConfigurationItem <String[]>]
   [-AddOSConfigurationItem <String[]>]
   [-AddProhibitedConfigurationItem <String[]>]
   [-AddRequiredConfigurationItem <String[]>]
   [-AddSoftwareUpdate <String[]>]
   [-AllowComanagedClients <Boolean>]
   [-ClearBaseline]
   [-ClearOptionalConfigurationItem]
   [-ClearOSConfigurationItem]
   [-ClearProhibitedConfigurationItem]
   [-ClearRequiredConfigurationItem]
   [-ClearSoftwareUpdate]
   [-Description <String>]
   [-DesiredConfigurationDigestPath <String>]
   -InputObject <IResultObject>
   [-NewName <String>]
   [-PassThru]
   [-RemoveBaseline <String[]>]
   [-RemoveCategory <String[]>]
   [-RemoveOptionalConfigurationItem <String[]>]
   [-RemoveOSConfigurationItem <String[]>]
   [-RemoveProhibitedConfigurationItem <String[]>]
   [-RemoveRequiredConfigurationItem <String[]>]
   [-RemoveSoftwareUpdate <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Используйте этот командлет для изменения параметров базовой конфигурации в Configuration Manager. Базовый план конфигурации может включать следующие типы данных конфигурации:

Элементы конфигурации
Другие базовые конфигурации
Обновления программного обеспечения

Клиент Configuration Manager оценивает соответствие этому базовому плану. Если все указанные элементы соответствуют требованиям, то сам базовый план оценивается как соответствующий. Можно также включить необязательные элементы, которые оцениваются только в том случае, если на устройстве существует соответствующее приложение или параметр.

Дополнительные сведения см. в разделе Создание базовых показателей конфигурации в Configuration Manager.

Примечание.

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

Примеры

Пример 1. Настройка базовой конфигурации

В этом примере сначала используется командлет Get-CMConfigurationItem для получения ряда элементов конфигурации (CIs).

Затем он разбивает параметры командлета в переменную параметров . Это не обязательно для splat параметры, это просто упрощает чтение параметров для такой длинной командной строки.

Последняя команда настраивает базовый план PSTestBaseLine с новым именем и описанием, удаляет категорию и добавляет CIS.

$objPSTestWinAppCI = Get-CMConfigurationItem -Name PSTestWinAppCI
$objPSTestWinAppCI2 = Get-CMConfigurationItem -Name PSTestWinAppCI2
$objPSTestWinOSCI = Get-CMConfigurationItem -Name PSTestWinOSCI
$objPSTestWinAppCI3 = Get-CMConfigurationItem -Name PSTestWinAppCI3
$objPSTestWinAppCI4 = Get-CMConfigurationItem -Name PSTestWinAppCI4
$objPSTestMDCI = Get-CMConfigurationItem -Name PSTestMDCI
$objPSTestMacCI = Get-CMConfigurationItem -Name PSTestMacCI

$parameters = @{
  Name = "PSTestBaseLine"
  NewName = "PSTestBaseLineNew"
  Description = "DCM Testing New"
  RemoveCategory = ("IT Infrastructure")
  AddRequiredConfigurationItems = ($objPSTestWinAppCI4.CI_ID,$objPSTestMDCI.CI_ID)
  AddProhibitedConfigurationItems = ($objPSTestWinAppCI.CI_ID)
  AddOSConfigurationItems = ($objPSTestWinOSCI.CI_ID,$objPSTestMacCI.CI_ID)
  AddOptionalConfigurationItems = ($objPSTestWinAppCI2.CI_ID,$objPSTestWinAppCI3.CI_ID)
}

Set-CMBaseline @parameters

Пример 2. Добавление настраиваемой категории

В этом примере сначала используется командлет New-CMCategory для создания пользовательской базовой категории Бухгалтерия. Затем он настраивает базовый план бухгалтерского учета для добавления новой категории.

$category = New-CMCategory -CategoryType BaselineCategories -Name "Accounting"
Set-CMBaseline -Name "Accounting baseline" -AddCategory $category.LocalizedCategoryInstanceName

Параметры

-AddBaseline

Укажите массив идентификаторов базовых показателей, добавляемых в качестве данных конфигурации в целевой базовый план. Это значение является CI_ID свойством базового плана, например 16777516.

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

-AddCategory

Укажите массив имен категорий конфигурации для добавления в базовые конфигурации. Эти категории улучшают поиск и фильтрацию. По умолчанию сайт включает следующие категории для базовых конфигураций:

Клиент
ИТ-инфраструктура
Сфера деятельности
Сервер

Чтобы использовать другую категорию, сначала добавьте ее с помощью командлета и -CategoryType BaselineCategories параметра New-CMCategory.

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

-AddOptionalConfigurationItem

Укажите массив идентификаторов элементов конфигурации для добавления с необязательным назначением. Клиент Configuration Manager оценивает необязательные элементы только в том случае, если на устройстве существует соответствующее приложение.

Это значение является свойством CI_ID элемента конфигурации, например 16777514.

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

-AddOSConfigurationItem

Укажите массив идентификаторов элементов конфигурации для добавления типа ОС. Это значение является свойством CI_ID элемента конфигурации, например 16777514.

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

-AddProhibitedConfigurationItem

Укажите массив идентификаторов элементов конфигурации для добавления с запрещенным назначением . Это значение является свойством CI_ID элемента конфигурации, например 16777514.

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

-AddRequiredConfigurationItem

Укажите массив идентификаторов элементов конфигурации для добавления с необходимой целью. Это значение является свойством CI_ID элемента конфигурации, например 16777514.

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

-AddSoftwareUpdate

Укажите массив идентификаторов обновлений программного обеспечения для добавления.

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

-AllowComanagedClients

Присвойте этому параметру значение , $true чтобы всегда применять этот базовый план даже для совместно управляемых клиентов.

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

-ClearBaseline

Добавьте этот параметр, чтобы удалить все базовые показатели в качестве условий оценки из целевого базового плана. Чтобы удалить отдельные базовые показатели, используйте параметр RemoveBaseline .

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

-ClearOptionalConfigurationItem

Добавьте этот параметр, чтобы удалить все необязательные элементы конфигурации в качестве условий оценки из целевого базового плана. Чтобы удалить отдельные необязательные CIs, используйте параметр RemoveOptionalConfigurationItem .

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

-ClearOSConfigurationItem

Добавьте этот параметр, чтобы удалить все элементы конфигурации ОС в качестве условий оценки из целевого базового плана. Чтобы удалить отдельные CIS ОС, используйте параметр RemoveOSConfigurationItem .

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

-ClearProhibitedConfigurationItem

Добавьте этот параметр, чтобы удалить все запрещенные элементы конфигурации в качестве условий оценки из целевого базового плана. Чтобы удалить отдельные запрещенные CIs, используйте параметр RemoveProhibitedConfigurationItem .

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

-ClearRequiredConfigurationItem

Добавьте этот параметр, чтобы удалить все необходимые элементы конфигурации в качестве условий оценки из целевого базового плана. Чтобы удалить отдельные необходимые CIs, используйте параметр RemoveRequiredConfigurationItem .

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

-ClearSoftwareUpdate

Добавьте этот параметр, чтобы удалить все обновления программного обеспечения в качестве условий оценки из целевого базового плана. Чтобы удалить отдельные обновления программного обеспечения, используйте параметр RemoveSoftwareUpdate .

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

-DesiredConfigurationDigestPath

Укажите путь к данным конфигурации, хранящимся в виде 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

Укажите CI_ID настраиваемого базового плана конфигурации. Например, 16777516.

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

-InputObject

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

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

-Name

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

Тип:	String
Aliases:	LocalizedDisplayName
Position:	Named
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

-RemoveBaseline

Укажите массив идентификаторов базовых показателей для удаления в качестве данных конфигурации из целевого базового плана. Это значение является CI_ID свойством базового плана, например 16777516. Чтобы удалить все базовые показатели в качестве данных конфигурации из этого базового плана, используйте параметр ClearBaseline .

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

-RemoveCategory

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

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

-RemoveOptionalConfigurationItem

Укажите массив необязательных идентификаторов CI для удаления в качестве данных конфигурации из целевого базового плана. Это значение является свойством CI_ID элемента конфигурации, например 16777514. Чтобы удалить все необязательные элементы конфигурации из этого базового плана, используйте параметр ClearOptionalConfigurationItem .

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

-RemoveOSConfigurationItem

Укажите массив идентификаторов CI OS для удаления в качестве данных конфигурации из целевого базового плана. Это значение является свойством CI_ID элемента конфигурации, например 16777514. Чтобы удалить все элементы конфигурации ОС из этого базового плана, используйте параметр ClearOSConfigurationItem .

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

-RemoveProhibitedConfigurationItem

Укажите массив запрещенных идентификаторов CI для удаления в качестве данных конфигурации из целевого базового плана. Это значение является свойством CI_ID элемента конфигурации, например 16777514. Чтобы удалить все запрещенные элементы конфигурации из этого базового плана, используйте параметр ClearProhibitedConfigurationItem .

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

-RemoveRequiredConfigurationItem

Укажите массив обязательных идентификаторов CI для удаления в качестве данных конфигурации из целевого базового плана. Это значение является свойством CI_ID элемента конфигурации, например 16777514. Чтобы удалить все необходимые элементы конфигурации из этого базового плана, используйте параметр ClearRequiredConfigurationItem .

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

-RemoveSoftwareUpdate

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

Тип:	String[]
Aliases:	RemoveSoftwareUpdates
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

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