Set-CMBaseline
Cambie la configuración de las líneas base de configuración.
Syntax
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 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 Configuration Manager, por ejemploPS 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, salpica 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
.
Type: | String[] |
Aliases: | AddBaselines |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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:
- Client
- 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.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AddOptionalConfigurationItem
Especifique una matriz de identificadores de elemento de configuración que se van a agregar con un propósito opcional . El cliente 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
.
Type: | String[] |
Aliases: | AddOptionalConfigurationItems |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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
.
Type: | String[] |
Aliases: | AddOSConfigurationItems |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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
.
Type: | String[] |
Aliases: | AddProhibitedConfigurationItems |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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
.
Type: | String[] |
Aliases: | AddRequiredConfigurationItems |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AddSoftwareUpdate
Especifique una matriz de identificadores de actualización de software que se van a agregar.
Type: | String[] |
Aliases: | AddSoftwareUpdates |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowComanagedClients
Establezca este parámetro $true
en para aplicar siempre esta línea base incluso para los clientes administrados conjuntamente.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Solicitará confirmación antes de ejecutar el cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Especifique una descripción opcional de la línea base de configuración para ayudar a identificarla.
Type: | String |
Aliases: | LocalizedDescription |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DesiredConfigurationDigestPath
Especifique una ruta de acceso a los datos de configuración almacenados como un resumen XML.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
Especifique el CI_ID de la línea base de configuración que se va a configurar. Por ejemplo, 16777516
.
Type: | Int32 |
Aliases: | CIId, CI_ID |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | IResultObject |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Especifique el nombre de la línea base de configuración que se va a configurar.
Type: | String |
Aliases: | LocalizedDisplayName |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | String[] |
Aliases: | RemoveBaselines |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | String[] |
Aliases: | RemoveOptionalConfigurationItems |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | String[] |
Aliases: | RemoveOSConfigurationItems |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | String[] |
Aliases: | RemoveProhibitedConfigurationItems |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | String[] |
Aliases: | RemoveRequiredConfigurationItems |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | String[] |
Aliases: | RemoveSoftwareUpdates |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Salidas
System.Object
Vínculos relacionados
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de