Compartilhar via


Set-CMStatusFilterRule

Modifica as definições de uma regra de filtro do Configuration Manager para mensagens de estado.

Sintaxe

Set-CMStatusFilterRule
   [-AllowDeleteAfterDays <Int32>]
   [-ComponentName <String>]
   [-ForwardToStatusSummarizer <Boolean>]
   [-MessageId <Int32>]
   [-MessageType <MessageType>]
   -Name <String>
   [-Priority <PriorityChangeType>]
   [-ProcessLowerPriorityRule <Boolean>]
   [-ProgramPath <String>]
   [-PropertyId <String>]
   [-PropertyValue <String>]
   [-ReplicateToParentSite <Boolean>]
   [-ReplicationPriority <ReplicationPriority>]
   [-ReportToEventLog <Boolean>]
   [-RunProgram <Boolean>]
   [-SeverityType <SeverityType>]
   [-SiteCode <String>]
   [-SiteSystemServerName <String>]
   [-Source <String>]
   [-StatusFilterRuleSiteCode <String>]
   [-WriteToDatabase <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet Set-CMStatusFilterRule modifica as definições de uma regra de filtro do Configuration Manager para mensagens de estado. O Configuration Manager verifica uma mensagem de estado em relação às regras por ordem de prioridade. Uma regra pode especificar que as regras com prioridade inferior não se aplicam a uma mensagem após a aplicação dessa regra.

As regras do filtro de estado especificam como o Configuration Manager responde às mensagens de estado. Cada regra de filtro contém critérios e ações para mensagens de estado. Pode configurar regras de filtro de estado para cada site, não em todos os sites.

Para alterar a prioridade de uma regra, utilize o nome da regra para especificar a regra.

Observação

Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.

Exemplos

Exemplo 1: Aumentar a prioridade de uma regra

PS XYZ:\> Set-CMStatusFilterRule -Name "Status change to critical" -SiteCode "CM1" -Priority Increase

Este comando aumenta a prioridade de uma regra de filtro que tem o nome especificado num site que tem o código do site CM1.

Parâmetros

-AllowDeleteAfterDays

Tipo:Int32
Aliases:AllowUserDeleteMessagesAfterThresholdDays
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ComponentName

Especifica o componente do Configuration Manager que corresponde às mensagens de estado.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForwardToStatusSummarizer

Indica se pretende reencaminhar para o summarizer de estado.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MessageId

Especifica um ID de mensagem no Configuration Manager.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MessageType

Especifica um tipo de mensagem de estado no Configuration Manager.

Os valores válidos são:

  • Auditoria
  • Detalhe
  • Etapa
  • Nenhum
Tipo:MessageType
Valores aceitos:None, Milestone, Detail, Audit
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifica uma matriz de nomes para regras de filtro de estado.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:True

-Priority

Especifica uma alteração de prioridade. O Configuration Manager verifica as mensagens de estado em relação às regras por ordem de prioridade da regra. Os valores válidos são: Diminuir e Aumentar.

Tipo:PriorityChangeType
Valores aceitos:Increase, Decrease
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ProcessLowerPriorityRule

Indica se pretende processar uma regra de prioridade inferior, o que impede o processamento de regras adicionais.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ProgramPath

Especifica um caminho para um programa que é executado quando uma mensagem de estado corresponde à regra do filtro de estado.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PropertyId

Especifica um ID de propriedade no Configuration Manager.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PropertyValue

Especifica um valor para o parâmetro PropertyId correspondente.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ReplicateToParentSite

Indica se deve transmitir uma mensagem para o site principal.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ReplicationPriority

Especifica uma prioridade de replicação para enviar mensagens de estado para o site principal.

Os valores válidos são:

  • Alto
  • Baixo
  • Médio
Tipo:ReplicationPriority
Valores aceitos:High, Medium, Low
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ReportToEventLog

Indica se pretende comunicar um evento no registo de eventos do Windows.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RunProgram

Indica se deve executar um programa quando uma mensagem de estado corresponde a uma regra de filtro.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SeverityType

Especifica a gravidade de uma mensagem de estado.

Os valores válidos são:

  • Erro
  • Informativo
  • Nenhum
  • Aviso
Tipo:SeverityType
Valores aceitos:None, Informational, Warning, Error
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SiteCode

Especifica o código do site para um site do Configuration Manager.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SiteSystemServerName

Especifica o nome de um servidor do sistema de sites no Configuration Manager.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Source

Especifica a origem da mensagem de estado a corresponder. As origens possíveis são as seguintes:

  • Cliente
  • Provedor de SMS
  • Servidor do Site
Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-StatusFilterRuleSiteCode

Especifica um código de site para o site a partir do qual a mensagem de estado teve origem.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WriteToDatabase

Indica se deve escrever uma mensagem na base de dados. Especifique um valor de $True para este parâmetro para ativar o parâmetro AllowUserDeleteMessagesAfterThresholdDays .

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None