Share via

Set-CMStatusFilterRule

  • Referência
Módulo:
ConfigurationManager

Modifica as configurações de uma regra de filtro Configuration Manager para mensagens de status.

Syntax

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 configurações para uma regra de filtro Configuration Manager para mensagens de status. Configuration Manager verifica uma mensagem de status em relação às regras por ordem de prioridade. Uma regra pode especificar que regras com prioridade inferior não se aplicam a uma mensagem depois que essa regra é aplicada.

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

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

Observação

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

Exemplos

Exemplo 1: aumentar a prioridade de uma regra

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

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

Parâmetros

-AllowDeleteAfterDays

Type:Int32
Aliases:AllowUserDeleteMessagesAfterThresholdDays
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ComponentName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForwardToStatusSummarizer

Indica se deve encaminhar para o resumo de status.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MessageId

Especifica uma ID de mensagem no Configuration Manager.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MessageType

Especifica um tipo de mensagem de status no Configuration Manager.

Os valores válidos são:

  • Auditoria
  • Detalhe
  • Marco
  • Nenhum
Type:MessageType
Accepted values:None, Milestone, Detail, Audit
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:True

-Priority

Especifica uma alteração na prioridade. Configuration Manager verifica mensagens de status em relação às regras por ordem de prioridade de regra. Os valores válidos são: Diminuir e aumentar.

Type:PriorityChangeType
Accepted values:Increase, Decrease
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProcessLowerPriorityRule

Indica se deve processar uma regra de menor prioridade, o que impede o processamento de regras adicionais.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProgramPath

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PropertyId

Especifica uma ID de propriedade no Configuration Manager.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PropertyValue

Especifica um valor para o parâmetro PropertyId correspondente.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ReplicateToParentSite

Indica se deve passar uma mensagem para o site pai.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ReplicationPriority

Especifica uma prioridade de replicação para enviar mensagens de status para o site pai.

Os valores válidos são:

  • Alto
  • Baixo
  • Médio
Type:ReplicationPriority
Accepted values:High, Medium, Low
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ReportToEventLog

Indica se deve relatar um evento no log de eventos do Windows.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunProgram

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SeverityType

Especifica a gravidade de uma mensagem de status.

Os valores válidos são:

  • Error
  • Informativo
  • Nenhum
  • Aviso
Type:SeverityType
Accepted values:None, Informational, Warning, Error
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SiteCode

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SiteSystemServerName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Source

Especifica a fonte de mensagem de status a ser correspondida. As possíveis fontes são as seguintes:

  • Client
  • Provedor de SMS
  • Servidor de Site
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-StatusFilterRuleSiteCode

Especifica um código de site para o site do qual a mensagem de status se originou.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WriteToDatabase

Indica se deve gravar uma mensagem no banco de dados. Especifique um valor de $True para esse parâmetro para habilitar o parâmetro AllowUserDeleteMessagesAfterThresholdDays .

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

None