Compartir a través de

Set-CMConfigurationItem

  • Referencia
Módulo:
ConfigurationManager

Cambia la configuración de un elemento de configuración de Configuration Manager.

Sintaxis

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

Description

El cmdlet Set-CMConfigurationItem cambia la configuración de un elemento de configuración de Configuration Manager.

Los elementos de configuración contienen una o varias opciones de configuración, junto con las reglas de cumplimiento. Los elementos suelen definir una unidad de configuración que desea supervisar. Para obtener más información sobre los elementos de configuración, consulte Introducción a la configuración de cumplimiento 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: Cambiar el nombre de un elemento de configuración

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

Este comando cambia el nombre del elemento de configuración denominado CITest a CITest01.

Ejemplo 2: Establecer la configuración del elemento

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

Este comando establece la acción de ámbito de seguridad en AddMembership y el nombre del ámbito de seguridad en DefaultScope para el elemento denominado CITest01.

Ejemplo 3: Cambiar la configuración del elemento

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

Este comando establece la acción de ámbito de seguridad en RemoveMembership y el nombre del ámbito de seguridad en DefaultScope para el elemento denominado CITest01.

Parámetros

-AddCategory

Especifica una matriz de nombres localizados de las categorías a las que pertenece el elemento de configuración.

Tipo:String[]
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

Especifica una descripción para un elemento de configuración.

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

-Digest

Especifica el resumen que contiene el elemento de configuración.

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

-DigestPath

Especifica la ruta de acceso del resumen.

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

-DigestXml

Especifica la definición 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

Especifica una matriz de identificadores para uno o varios elementos de configuración. Puede usar una lista separada por comas.

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

-InputObject

Especifica un objeto de elemento de configuración. Para obtener un objeto de elemento de configuración, puede usar el cmdlet Get-CMConfigurationItem .

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

-Name

Especifica una matriz de nombres para los elementos de configuración.

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

-NewName

Especifica un nuevo nombre para un elemento de configuración.

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

-PassThru

Devuelve el objeto de trabajo actual. De forma predeterminada, este cmdlet no genera resultados.

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

-RemoveCategory

Especifica una matriz de nombres localizados de las categorías de las que se va a quitar el elemento de configuración.

Tipo:String[]
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