Set-CMBaseline

Módulo:

ConfigurationManager

Cambie la configuración de las líneas base de configuración.

Sintaxis

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>]

Description

Use este cmdlet para cambiar la configuración de una línea base de configuración en Configuration Manager. Una línea base de configuración puede incluir los siguientes tipos de datos de configuración:

• Elementos de configuración
• Otras líneas base de configuración
• Actualizaciones de software

El cliente de Configuration Manager evalúa su cumplimiento con respecto a esta línea base. Si todos los elementos especificados son compatibles, la propia línea base se evalúa como compatible. También puede incluir elementos opcionales, que solo se evalúan si la aplicación o configuración pertinente existe en el dispositivo.

Para obtener más información, consulte Creación de líneas base de configuración en Configuration Manager.

Nota:

Ejecute cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>. Para obtener más información, consulte Introducción.

Ejemplos

Ejemplo 1: Configuración de una línea base de configuración

En este ejemplo se usa primero el cmdlet Get-CMConfigurationItem para obtener una serie de elementos de configuración (CIs).

A continuación, se salpican los parámetros del cmdlet en la variable parameters . No es necesario salpicar los parámetros, simplemente facilita la lectura de los parámetros de una línea de comandos tan larga.

El último comando configura la línea base PSTestBaseLine con un nuevo nombre y una descripción, quita una categoría y agrega las 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

Ejemplo 2: Agregar una categoría personalizada

En este ejemplo se usa primero el cmdlet New-CMCategory para crear una categoría de línea base personalizada Contabilidad. A continuación, configura la línea base contabilidad para agregar la nueva categoría.

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

Parámetros

-AddBaseline

Especifique una matriz de identificadores de línea base para agregar como datos de configuración a la línea base de destino. Este valor es la propiedad CI_ID de la línea base, por ejemplo, 16777516.

Tipo:	String[]
Alias:	AddBaselines
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-AddCategory

Especifique una matriz de nombres de categoría de configuración que se van a agregar a las líneas base de configuración. Estas categorías mejoran la búsqueda y el filtrado. De forma predeterminada, el sitio incluye las siguientes categorías para las líneas base de configuración:

• Cliente
• Infraestructura de TI
• Línea de negocio
• Servidor

Para usar otra categoría, agréguela primero con el cmdlet y -CategoryType BaselineCategories el parámetro New-CMCategory.

Tipo:	String[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-AddOptionalConfigurationItem

Especifique una matriz de identificadores de elemento de configuración que se van a agregar con un propósito opcional . El cliente de Configuration Manager solo evalúa los elementos opcionales si la aplicación pertinente existe en el dispositivo.

Este valor es la propiedad CI_ID del elemento de configuración, por ejemplo, 16777514.

Tipo:	String[]
Alias:	AddOptionalConfigurationItems
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-AddOSConfigurationItem

Especifique una matriz de identificadores de elemento de configuración que se van a agregar de tipo OS. Este valor es la propiedad CI_ID del elemento de configuración, por ejemplo, 16777514.

Tipo:	String[]
Alias:	AddOSConfigurationItems
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-AddProhibitedConfigurationItem

Especifique una matriz de identificadores de elemento de configuración que se van a agregar con un propósito prohibido . Este valor es la propiedad CI_ID del elemento de configuración, por ejemplo, 16777514.

Tipo:	String[]
Alias:	AddProhibitedConfigurationItems
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-AddRequiredConfigurationItem

Especifique una matriz de identificadores de elemento de configuración que se van a agregar con un propósito necesario . Este valor es la propiedad CI_ID del elemento de configuración, por ejemplo, 16777514.

Tipo:	String[]
Alias:	AddRequiredConfigurationItems
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-AddSoftwareUpdate

Especifique una matriz de identificadores de actualización de software que se van a agregar.

Tipo:	String[]
Alias:	AddSoftwareUpdates
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-AllowComanagedClients

Establezca este parámetro $true en para aplicar siempre esta línea base incluso para los clientes administrados conjuntamente.

Tipo:	Boolean
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ClearBaseline

Agregue este parámetro para quitar todas las líneas base como condiciones de evaluación de la línea base de destino. Para quitar líneas base individuales, use el parámetro RemoveBaseline .

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ClearOptionalConfigurationItem

Agregue este parámetro para quitar todos los elementos de configuración opcionales como condiciones de evaluación de la línea base de destino. Para quitar las CIs opcionales individuales, use el parámetro RemoveOptionalConfigurationItem .

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ClearOSConfigurationItem

Agregue este parámetro para quitar todos los elementos de configuración del sistema operativo como condiciones de evaluación de la línea base de destino. Para quitar las CIs individuales del sistema operativo, use el parámetro RemoveOSConfigurationItem .

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ClearProhibitedConfigurationItem

Agregue este parámetro para quitar todos los elementos de configuración prohibidos como condiciones de evaluación de la línea base de destino. Para quitar las CIs prohibidas individuales, use el parámetro RemoveProhibitedConfigurationItem .

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ClearRequiredConfigurationItem

Agregue este parámetro para quitar todos los elementos de configuración necesarios como condiciones de evaluación de la línea base de destino. Para quitar las CIs necesarias individuales, use el parámetro RemoveRequiredConfigurationItem .

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ClearSoftwareUpdate

Agregue este parámetro para quitar todas las actualizaciones de software como condiciones de evaluación de la línea base de destino. Para quitar actualizaciones de software individuales, use el parámetro RemoveSoftwareUpdate .

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posición:	Named
Valor predeterminado:	False
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Description

Especifique una descripción opcional de la línea base de configuración para ayudar a identificarla.

Tipo:	String
Alias:	LocalizedDescription
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DesiredConfigurationDigestPath

Especifique una ruta de acceso a los datos de configuración almacenados como un resumen XML.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Id

Especifique el CI_ID de la línea base de configuración que se va a configurar. Por ejemplo, 16777516.

Tipo:	Int32
Alias:	CIId, CI_ID
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-InputObject

Especifique un objeto de línea base de configuración que se va a configurar. Para obtener este objeto, use el cmdlet Get-CMBaseline .

Tipo:	IResultObject
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Name

Especifique el nombre de la línea base de configuración que se va a configurar.

Tipo:	String
Alias:	LocalizedDisplayName
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-NewName

Especifique un nuevo nombre para la línea base de configuración. Use este parámetro para cambiar el nombre de la línea base de destino.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-PassThru

Agregue este parámetro para devolver un objeto que represente el elemento con el que está trabajando. De forma predeterminada, este cmdlet no puede generar ninguna salida.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-RemoveBaseline

Especifique una matriz de identificadores de línea base que se van a quitar como datos de configuración de la línea base de destino. Este valor es la propiedad CI_ID de la línea base, por ejemplo, 16777516. Para quitar todas las líneas base como datos de configuración de esta línea base, use el parámetro ClearBaseline .

Tipo:	String[]
Alias:	RemoveBaselines
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-RemoveCategory

Especifique una matriz de nombres de categorías de configuración que se van a quitar de la línea base de configuración.

Tipo:	String[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-RemoveOptionalConfigurationItem

Especifique una matriz de identificadores de CI opcionales que se van a quitar como datos de configuración de la línea base de destino. Este valor es la propiedad CI_ID del elemento de configuración, por ejemplo, 16777514. Para quitar todos los elementos de configuración opcionales de esta línea base, use el parámetro ClearOptionalConfigurationItem .

Tipo:	String[]
Alias:	RemoveOptionalConfigurationItems
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-RemoveOSConfigurationItem

Especifique una matriz de identificadores de CI del sistema operativo que se van a quitar como datos de configuración de la línea base de destino. Este valor es la propiedad CI_ID del elemento de configuración, por ejemplo, 16777514. Para quitar todos los elementos de configuración del sistema operativo de esta línea base, use el parámetro ClearOSConfigurationItem .

Tipo:	String[]
Alias:	RemoveOSConfigurationItems
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-RemoveProhibitedConfigurationItem

Especifique una matriz de identificadores de CI prohibidos que se van a quitar como datos de configuración de la línea base de destino. Este valor es la propiedad CI_ID del elemento de configuración, por ejemplo, 16777514. Para quitar todos los elementos de configuración prohibidos de esta línea base, use el parámetro ClearProhibitedConfigurationItem .

Tipo:	String[]
Alias:	RemoveProhibitedConfigurationItems
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-RemoveRequiredConfigurationItem

Especifique una matriz de identificadores de CI necesarios que se van a quitar como datos de configuración de la línea base de destino. Este valor es la propiedad CI_ID del elemento de configuración, por ejemplo, 16777514. Para quitar todos los elementos de configuración necesarios de esta línea base, use el parámetro ClearRequiredConfigurationItem .

Tipo:	String[]
Alias:	RemoveRequiredConfigurationItems
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-RemoveSoftwareUpdate

Especifique una matriz de identificadores de actualización de software que se van a quitar como datos de configuración de la línea base de destino. Para quitar todas las actualizaciones de software de esta línea base, use el parámetro ClearSoftwareUpdate .

Tipo:	String[]
Alias:	RemoveSoftwareUpdates
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-WhatIf

Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.

Tipo:	SwitchParameter
Alias:	wi
Posición:	Named
Valor predeterminado:	False
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Salidas

System.Object

Vínculos relacionados

• Disable-CMBaseline
• Enable-CMBaseline
• Export-CMBaseline
• Get-CMBaseline
• Import-CMBaseline
• New-CMBaseline
• Remove-CMBaseline
• Get-CMBaselineXMLDefinition
• Get-CMBaselineSummarizationSchedule
• Creación de líneas base de configuración en Configuration Manager