Compartir a través de

Remove-CMConfigurationPolicy

  • Referencia
Módulo:
ConfigurationManager

Quita una directiva de configuración.

Sintaxis

Remove-CMConfigurationPolicy
      [-Force]
      [-InputObject] <IResultObject>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMConfigurationPolicy
      [-Force]
      [-Id] <Int32>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMConfigurationPolicy
      [-Force]
      [-Name] <String[]>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

El cmdlet Remove-CMConfigurationPolicy quita una directiva de configuración. Una directiva de configuración puede ser un perfil de correo electrónico, una directiva de firewall u otros. Consulte la sección Alias para ver los tipos de directiva adicionales que puede usar este cmdlet para quitar.

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: Eliminación de una directiva de configuración por identificador

PS XYZ:\> Remove-CMConfigurationPolicy -ID 16777454 -Force

Este comando quita la directiva de configuración con el CI_ID de 16777454, sin pedir confirmación al usuario.

Ejemplo 2: Quitar una directiva de configuración por nombre

PS XYZ:\> Get-CMcertificateProfilePfx -Name "CertProf1" | Remove-CMConfigurationPolicy

Este comando obtiene el objeto de perfil de certificado PFX denominado CertProf01 y usa el operador de canalización para pasar el objeto a Remove-CMConfigurationPolicy , lo que quita el perfil de certificado.

Parámetros

-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

-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

-Force

Obliga al comando a ejecutarse sin pedir confirmación del usuario.

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 el CI__ID de una directiva de configuración.

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 directiva de configuración. Para obtener un objeto de directiva de configuración, use el cmdlet Get-CMConfigurationPolicy.

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 de directivas 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

-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