Set-CMStatusMessageQuery
SYNOPSIS
Altera as definições ou o âmbito de segurança ou elimina as mensagens para uma consulta de mensagem de verificação do Gestor de Configuração.
SYNTAX
SetStatusMessageQueryByObjectMandatory (Padrão)
Set-CMStatusMessageQuery [-Comment <String>] [-Expression <String>] -InputObject <IResultObject>
[-NewName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
SetStatusMessageQueryByIdMandatory
Set-CMStatusMessageQuery [-Comment <String>] [-Expression <String>] -Id <String> [-NewName <String>]
[-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
SetStatusMessageQueryByNameMandatory
Set-CMStatusMessageQuery [-Comment <String>] [-Expression <String>] -Name <String> [-NewName <String>]
[-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
DeleteMessageByObjectMandatory
Set-CMStatusMessageQuery [-DeleteMessage] -InputObject <IResultObject> [-PassThru] [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
DeleteMessageByNameMandatory
Set-CMStatusMessageQuery [-DeleteMessage] -Name <String> [-PassThru] [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
DeleteMessageByIdMandatory
Set-CMStatusMessageQuery [-DeleteMessage] -Id <String> [-PassThru] [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
O cmdlet Set-CMStatusMessageQuery altera as definições para uma consulta de mensagem de estado do Gestor de Configuração. As consultas de mensagens de estado devolvem mensagens de estado de uma base de dados do site do Gestor de Configuração. Pode modificar um comentário, uma expressão Windows Infraestrutura de Gestão (WMI) ou o nome de uma consulta.
Pode utilizar este cmdlet com o parâmetro DeleteMessage para eliminar as mensagens que esta consulta encontra.
Este cmdlet também pode adicionar ou remover um âmbito de segurança para uma consulta de mensagem. Todas as consultas de mensagem de estado devem 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.
Nota
Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\> . Para mais informações, consulte a partida.
EXAMPLES
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 chamado 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 chamada All Ative Directory Security Groups da base de dados Do Gestor de Configuração.
Exemplo 3: Mudar o nome de uma consulta
PS XYZ:\> Set-CMStatusMessageQuery -Name "All Active Directory Security Groups" -NewName "Western Security Groups"
Este comando renomea a consulta Todos os Grupos de Segurança do Diretório Ativo. O novo nome da consulta é Western Security Groups.
PARAMETERS
-Comentário
Type: String
Parameter Sets: SetStatusMessageQueryByObjectMandatory, SetStatusMessageQueryByIdMandatory, SetStatusMessageQueryByNameMandatory
Aliases: Comments
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Solicita a sua confirmação antes de executar o cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-Excluir Amissão
Indica que as mensagens encontradas por esta consulta são eliminadas da base de dados do Gestor de Configuração.
Type: SwitchParameter
Parameter Sets: DeleteMessageByObjectMandatory, DeleteMessageByNameMandatory, DeleteMessageByIdMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Este parâmetro trata os caracteres wildcard como valores de caracteres literais. Não pode combiná-lo com ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Expressão
Especifica uma expressão na linguagem de consulta WMI (WQL).
Type: String
Parameter Sets: SetStatusMessageQueryByObjectMandatory, SetStatusMessageQueryByIdMandatory, SetStatusMessageQueryByNameMandatory
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Este parâmetro processa caracteres wildcard e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
- ID
Especifica um ID para uma consulta de mensagem de estado.
Type: String
Parameter Sets: SetStatusMessageQueryByIdMandatory, DeleteMessageByIdMandatory
Aliases: QueryId
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: 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.
Type: IResultObject
Parameter Sets: SetStatusMessageQueryByObjectMandatory, DeleteMessageByObjectMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Name
Especifica um nome para uma consulta de mensagem de estado.
Type: String
Parameter Sets: SetStatusMessageQueryByNameMandatory, DeleteMessageByNameMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Novo Nome
Especifica um novo nome para uma consulta.
Type: String
Parameter Sets: SetStatusMessageQueryByObjectMandatory, SetStatusMessageQueryByIdMandatory, SetStatusMessageQueryByNameMandatory
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
- PassThru
Adicione este parâmetro para devolver um objeto que represente o item com o qual está a trabalhar. Por predefinição, este cmdlet pode não gerar qualquer saída.
Type: SwitchParameter
Parameter Sets: DeleteMessageByObjectMandatory, DeleteMessageByNameMandatory, DeleteMessageByIdMandatory
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
- O QueIf
Apresenta o que aconteceria mediante a execução do cmdlet. O comandante não funciona.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.