Set-CMStatusMessageQuery
Altera definições ou âmbito de segurança ou elimina mensagens para uma consulta de mensagem de estado do Configuration Manager.
Sintaxe
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 definições de uma consulta de mensagem de estado do Configuration Manager. As consultas de mensagens de estado devolvem mensagens de estado de uma base de dados do site do Configuration Manager. Pode modificar um comentário, uma expressão da Infraestrutura de Gestão do Windows (WMI) ou o nome de uma consulta.
Pode utilizar este cmdlet com o parâmetro DeleteMessage para eliminar mensagens que esta consulta encontra.
Este cmdlet também pode adicionar ou remover um âmbito de segurança para uma consulta de mensagem. Cada consulta de mensagem de estado tem de pertencer a, pelo menos, um âmbito de segurança.
Pode especificar um nome ou ID para uma consulta ou utilizar o cmdlet Get-CMStatusMessageQuery para obter uma consulta.
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: Adicionar um âmbito de segurança
PS XYZ:\> Set-CMStatusMessageQuery -Name "All Status Messages" -SecurityScopeAction AddMembership -SecurityScopeName "Scope22"Este comando adiciona o âmbito de segurança denominado Scope22 à consulta denominada Todas as Mensagens de Estado.
Exemplo 2: Eliminar mensagens
PS XYZ:\> Set-CMStatusMessageQuery -DeleteMessage -Name "All Active Directory Security Groups"Este comando remove as mensagens encontradas pela consulta denominada Todos os Grupos de Segurança do Active Directory da base de dados do Configuration Manager.
Exemplo 3: Mudar o nome de uma consulta
PS XYZ:\> Set-CMStatusMessageQuery -Name "All Active Directory Security Groups" -NewName "Western Security Groups"Este comando muda o nome da consulta Todos os Grupos de Segurança do Active Directory. O novo nome da consulta são Grupos de Segurança Ocidentais.
Parâmetros
-Comment
| Tipo: | String |
| Aliases: | Comments |
| 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 |
-DeleteMessage
Indica que as mensagens encontradas por esta consulta são eliminadas da base de dados do Configuration Manager.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| 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 |
-Expression
Especifica uma expressão na WMI Query Language (WQL).
| Tipo: | String |
| 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 |
-Id
Especifica um ID para uma consulta de mensagem de estado.
| Tipo: | String |
| Aliases: | QueryId |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-InputObject
Especifica um objeto de consulta de mensagem de estado. Para obter um objeto de consulta de mensagem de estado, utilize o cmdlet Get-CMStatusMessageQuery .
| Tipo: | IResultObject |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-Name
Especifica um nome para uma consulta de mensagem de estado.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-NewName
Especifica um novo nome para uma consulta.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-PassThru
Adicione este parâmetro para devolver um objeto que representa o item com o qual está a trabalhar. Por predefinição, este cmdlet pode não gerar qualquer saída.
| Tipo: | SwitchParameter |
| 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 |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Saídas
System.Object