New-CMStatusFilterRule
Cria uma regra no Configuration Manager.
Sintaxe
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 aciona uma ou mais ações que alertam um administrador para uma mensagem específica no Configuration Manager.
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: Criar uma regra de filtro de estado
Este comando cria uma regra de filtro de estado no site XYZ para detetar a mensagem de estado 4611 e escrever um evento no registo do 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
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.
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 um nome para a regra de filtro de estado.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
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 aceitáveis para este parâmetro são: Alto, Baixo e Médio.
Tipo: | ReplicationPriority |
Valores aceitos: | Low, Medium, High |
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.
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 um código de site do Configuration Manager que define a regra de estado.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-SiteSystemServerName
Especifica um nome do servidor do sistema de sites.
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.
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 a regra de filtro de estado.
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. Tem de ser definido 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
Saídas
IResultObject