Set-CMConfigurationItem
Cambia la configuración de un elemento de configuración de Configuration Manager.
Syntax
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 Configuration Manager, por ejemploPS 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.
Type: | String[] |
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
Especifica una descripción para un elemento de configuración.
Type: | String |
Aliases: | LocalizedDescription |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Digest
Especifica el resumen que contiene el elemento de configuración.
Type: | ConfigurationItem |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DigestPath
Especifica la ruta de acceso del resumen.
Type: | String |
Aliases: | DesiredConfigurationDigestPath |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DigestXml
Especifica la definición 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
Especifica una matriz de identificadores para uno o varios elementos de configuración. Puede usar una lista separada por comas.
Type: | Int32 |
Aliases: | CIId, CI_ID |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | IResultObject |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Especifica una matriz de nombres para los elementos de configuración.
Type: | String |
Aliases: | LocalizedDisplayName |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NewName
Especifica un nuevo nombre para un elemento de configuración.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Devuelve el objeto de trabajo actual. De forma predeterminada, este cmdlet no genera resultados.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveCategory
Especifica una matriz de nombres localizados de las categorías de las que se va a quitar el elemento de configuración.
Type: | String[] |
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
- Introducción a la configuración de cumplimiento en Configuration Manager
- Get-CMConfigurationItem
- Get-CMConfigurationItemXMLDefinition
- Get-CMConfigurationItemHistory
- New-CMConfigurationItem
- Remove-CMConfigurationItem
- Import-CMConfigurationItem
- Export-CMConfigurationItem
- ConvertTo-CMConfigurationItem
- ConvertFrom-CMConfigurationItem
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