Share via


New-CMStatusFilterRule

Cria uma regra no Configuration Manager.

Syntax

New-CMStatusFilterRule
   [-AllowDeleteAfterDays <Int32>]
   [-ComponentName <String>]
   [-ForwardToStatusSummarizer <Boolean>]
   [-MessageId <Int32>]
   [-MessageType <MessageType>]
   -Name <String>
   [-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 New-CMStatusFilterRule cria uma regra que dispara uma ou mais ações que alertam um administrador para uma mensagem específica no Configuration Manager.

Observação

Execute cmdlets do Configuration Manager na unidade de site do Configuration Manager, por PS XYZ:\> exemplo. Para obter mais informações, consulte getting started.

Exemplos

Exemplo 1: Criar uma regra de filtro de status

Este comando cria uma regra de filtro de status no site XYZ para detectar a mensagem de status 4611 e gravar um evento no log Windows.

New-CMStatusFilterRule -SiteCode "XYZ" -Name "Detect when the component status summarizer resets the status of a component." -Source "Site Server" -ComponentName "SMS_COMPONENT_STATUS_SUMMARIZER" -MessageId "4611" -ReportToEventLog $True -ReplicateToParentSite $False -RunProgram $False -ForwardToStatusSummarizer $True -ProcessLowerPriorityRule $True

Parâmetros

-AllowDeleteAfterDays

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

-ComponentName

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

Type:String
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
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). Não é possível combiná-lo com DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False

-MessageId

Especifica uma ID de mensagem no Configuration Manager.

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

-MessageType

Especifica um tipo de mensagem de status no Configuration Manager.

Type:MessageType
Accepted values:None, Milestone, Detail, Audit
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifica um nome para a regra de filtro de status.

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

-ProcessLowerPriorityRule

Indica se deve processar uma regra de prioridade mais baixa, o que impede o processamento de novas regras.

Type:Boolean
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False

-PropertyId

Especifica uma ID de propriedade no Configuration Manager.

Type:String
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False

-ReplicationPriority

Especifica uma prioridade de replicação para o envio de mensagens de status para o site pai. Os valores aceitáveis para este parâmetro são: Alto, Baixo e Médio.

Type:ReplicationPriority
Accepted values:Low, Medium, High
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ReplicaToParentSite

Indica se uma mensagem deve ser enviada para o site pai.

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

-ReportToEventLog

Indica se um evento deve ser reportado no log Windows evento.

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

-RunProgram

Indica se um programa deve ser executado quando uma mensagem de status corresponde a uma regra de filtro.

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

-SeverityType

Especifica a gravidade de uma mensagem de status.

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

-SiteCode

Especifica um código de site do Configuration Manager que define a regra de status.

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

-SiteSystemServerName

Especifica um nome do servidor do sistema de sites.

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

-Source

Especifica a origem da mensagem de status a ser corresponder.

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

-StatusFilterRuleSiteCode

Especifica um código de site para a regra de filtro de status.

Type:String
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False

-WriteToDatabase

Indica se uma mensagem deve ser escrita no banco de dados. Deve ser definido para habilitar o parâmetro AllowUserDeleteMessagesAfterThresholdDays.

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

Entradas

Nenhum

Saídas

IResultObject