Share via

Set-CMStatusMessageQuery

  • Referência
Módulo:
ConfigurationManager

Altera configurações ou escopo de segurança ou exclui mensagens para uma consulta de mensagem de status do Configuration Manager.

Syntax

Set-CMStatusMessageQuery
   [-Comment <String>]
   [-Expression <String>]
   -InputObject <IResultObject>
   [-NewName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMStatusMessageQuery
   [-Comment <String>]
   [-Expression <String>]
   -Id <String>
   [-NewName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMStatusMessageQuery
   [-Comment <String>]
   [-Expression <String>]
   -Name <String>
   [-NewName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMStatusMessageQuery
   [-DeleteMessage]
   -InputObject <IResultObject>
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMStatusMessageQuery
   [-DeleteMessage]
   -Name <String>
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMStatusMessageQuery
   [-DeleteMessage]
   -Id <String>
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet Set-CMStatusMessageQuery altera as configurações de uma consulta de mensagem de status do Configuration Manager. As consultas de mensagem de status retornam mensagens de status de um banco de dados de site do Configuration Manager. Você pode modificar um comentário, uma expressão Windows infraestrutura de gerenciamento (WMI) ou o nome de uma consulta.

Você pode usar esse cmdlet com o parâmetro DeleteMessage para excluir mensagens que essa consulta encontra.

Esse cmdlet também pode adicionar ou remover um escopo de segurança para uma consulta de mensagem. Cada consulta de mensagem de status deve pertencer a pelo menos um escopo de segurança.

Você pode especificar um nome ou ID para uma consulta ou usar o cmdlet Get-CMStatusMessageQuery para obter uma consulta.

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: Adicionar um escopo de segurança

PS XYZ:\> Set-CMStatusMessageQuery -Name "All Status Messages" -SecurityScopeAction AddMembership -SecurityScopeName "Scope22"

Este comando adiciona o escopo de segurança chamado Scope22 à consulta chamada Todas as Mensagens de Status.

Exemplo 2: Excluir mensagens

PS XYZ:\> Set-CMStatusMessageQuery -DeleteMessage -Name "All Active Directory Security Groups"

Este comando remove mensagens encontradas pela consulta chamada Todos os Grupos de Segurança do Active Directory do banco de dados do Configuration Manager.

Exemplo 3: Renomear uma consulta

PS XYZ:\> Set-CMStatusMessageQuery -Name "All Active Directory Security Groups" -NewName "Western Security Groups"

Este comando renomeia a consulta Todos os Grupos de Segurança do Active Directory. O novo nome da consulta é Western Security Groups.

Parâmetros

-Comentário

Type:String
Aliases:Comments
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

-DeleteMessage

Indica que as mensagens encontradas por essa consulta são excluídas do banco de dados do Configuration Manager.

Type:SwitchParameter
Position:Named
Default value:None
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

-Expression

Especifica uma expressão em WMI Query Language (WQL).

Type:String
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

-Id

Especifica uma ID de uma consulta de mensagem de status.

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

-InputObject

Especifica um objeto de consulta de mensagem de status. Para obter um objeto de consulta de mensagem de status, use o cmdlet Get-CMStatusMessageQuery.

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

-Name

Especifica um nome para uma consulta de mensagem de status.

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

-NewName

Especifica um novo nome para uma consulta.

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

-PassThru

Adicione esse parâmetro para retornar um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet pode não gerar nenhuma saída.

Type:SwitchParameter
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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object