Dela via


Set-CMStatusMessageQuery

SYNOPSIS

Ändrar inställningar eller säkerhetsomfattning eller tar bort meddelanden för en Konfigurationshanteraren statusmeddelandefråga.

SYNTAX

SetStatusMessageQueryByObjectMandatory (standard)

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

Cmdleten Set-CMStatusMessageQuery ändrar inställningarna för en Konfigurationshanteraren statusmeddelandefråga. Statusmeddelandefrågor returnerar statusmeddelanden från en Konfigurationshanteraren platsdatabas. Du kan ändra en kommentar, Windows ett WMI-uttryck (Management Infrastructure) eller namnet på en fråga.

Du kan använda denna cmdlet med parametern DeleteMessage för att ta bort meddelanden som den här frågan hittar.

Den här cmdleten kan också lägga till eller ta bort en säkerhetsomfattning för en meddelandefråga. Varje statusmeddelandefråga måste tillhöra minst en säkerhetsomfattning.

Du kan ange ett namn eller ID för en fråga eller använda cmdleten Get-CMStatusMessageQuery för att hämta en fråga.

Anteckning

Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenheten, till exempel PS XYZ:\> . Mer information finns i Komma igång.

EXAMPLES

Exempel 1: Lägga till en säkerhetsomfattning

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

Det här kommandot lägger till säkerhetsomfattningen med namnet Scope22 till frågan Med namnet Alla statusmeddelanden.

Exempel 2: Ta bort meddelanden

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

Det här kommandot tar bort meddelanden som hittas av frågan med namnet Alla Active Directory-säkerhetsgrupper från Konfigurationshanteraren databasen.

Exempel 3: Byt namn på en fråga

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

Det här kommandot byter namn på frågan Alla Active Directory-säkerhetsgrupper. Det nya namnet på frågan är Western Security Groups.

PARAMETERS

-Kommentar

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

Uppmanar dig att bekräfta innan du kör cmdleten.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-DeleteMessage

Anger att meddelanden som hittas av den här frågan tas bort från Konfigurationshanteraren databasen.

Type: SwitchParameter
Parameter Sets: DeleteMessageByObjectMandatory, DeleteMessageByNameMandatory, DeleteMessageByIdMandatory
Aliases:

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

-DisableWildcardHandling

Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Uttryck

Anger ett uttryck i WMI Query Language (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

Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Id

Anger ett ID för en statusmeddelandefråga.

Type: String
Parameter Sets: SetStatusMessageQueryByIdMandatory, DeleteMessageByIdMandatory
Aliases: QueryId

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

-InputObject

Anger ett frågeobjekt för statusmeddelande. Om du vill hämta ett frågeobjekt för statusmeddelande använder du cmdleten 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

Anger ett namn på en statusmeddelandefråga.

Type: String
Parameter Sets: SetStatusMessageQueryByNameMandatory, DeleteMessageByNameMandatory
Aliases:

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

-NewName

Anger ett nytt namn för en fråga.

Type: String
Parameter Sets: SetStatusMessageQueryByObjectMandatory, SetStatusMessageQueryByIdMandatory, SetStatusMessageQueryByNameMandatory
Aliases:

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

-PassThru

Lägg till den här parametern för att returnera ett objekt som representerar det objekt som du arbetar med. Som standard genererar den här cmdleten kanske inte några utdata.

Type: SwitchParameter
Parameter Sets: DeleteMessageByObjectMandatory, DeleteMessageByNameMandatory, DeleteMessageByIdMandatory
Aliases:

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

ANTECKNINGAR

Get-CMStatusMessageQuery

New-CMStatusMessageQuery

Remove-CMStatusMessageQuery