Set-CMQuery

SYNOPSIS

Konfigurera en Konfigurationshanteraren fråga.

SYNTAX

SearchByValueMandatory (standard)

Set-CMQuery [-Comment <String>] [-Expression <String>] -InputObject <IResultObject>
 [-LimitToCollectionId <String>] [-NewName <String>] [-PassThru] [-TargetClassName <String>]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByIdMandatory

Set-CMQuery [-Comment <String>] [-Expression <String>] -Id <String> [-LimitToCollectionId <String>]
 [-NewName <String>] [-PassThru] [-TargetClassName <String>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByNameMandatory

Set-CMQuery [-Comment <String>] [-Expression <String>] [-LimitToCollectionId <String>] -Name <String>
 [-NewName <String>] [-PassThru] [-TargetClassName <String>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Använd denna cmdlet för att konfigurera en fråga i Konfigurationshanteraren. Konfigurationshanteraren definierar ett WMI Query Language -uttryck (WQL) för att hämta information från platsdatabasen baserat på de kriterier som du anger. WQL liknar den SQL, men går fortfarande via SMS-providern i stället för direkt till databasen. Så WQL följer fortfarande din rollbaserade åtkomstkonfiguration.

Frågor kan returnera de flesta typer Konfigurationshanteraren objekt, bland annat datorer, platser, samlingar, program och inventeringsdata. Mer information finns i Introduktion till frågor i Konfigurationshanteraren.

Som standard Konfigurationshanteraren flera frågor. Du kan använda cmdleten Get-CMQuery för att granska standardfrågorna. Fler exempel på WQL-uttryck finns i Exempel på WQL-frågor.

Anteckning

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

EXAMPLES

Exempel 1: Byt namn på en fråga

Get-CMQuery -Name "My systems" | Set-CMQuery -NewName "My systems v2"

Exempel 2: Ändra frågan för att fråga efter en begränsad samling

Set-CMQuery -Name "Windows 10" -LimitToCollectionId "<Prompt>"

PARAMETERS

-Kommentar

Ange en valfri kommentar för att ytterligare identifiera frågan på webbplatsen.

Type: String
Parameter Sets: (All)
Aliases:

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

-Expression

Ange den WQL-instruktion som definierar attributen som ska visas i resultaten och villkoren för att begränsa resultatet.

WQL-uttryck innehåller ofta dubbla citattecken ( ), så ange den här parameterns värde som en sträng som omges " av enkla citattecken ( ' ).

Fler exempel finns i Exempel på WQL-frågor.

Type: String
Parameter Sets: (All)
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

Ange ID för frågan som ska konfigureras. Till exempel "XYZ00006".

Type: String
Parameter Sets: SearchByIdMandatory
Aliases: QueryId

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

-InputObject

Ange ett frågeobjekt som ska konfigureras. Hämta det här objektet med cmdleten Get-CMQuery.

Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases:

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

-LimitToCollectionId

Ange hur du konfigurerar samlingsbegränsning för den här frågan:

• Inte samlingsbegränsat: Ange den här parameterns värde till en tom sträng ( "" ). Använd inte den $null inbyggda variabeln.
• Begränsa till samling: Ange ID:t för en samling. Till exempel för "SMSDM003" samlingen Alla skrivbords- och serverklienter.
• Fråga efter samling: Ange värdet för den här parametern till "<Prompt>" .

Type: String
Parameter Sets: (All)
Aliases:

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

-Name

Ange namnet på frågan som ska konfigureras.

Type: String
Parameter Sets: SearchByNameMandatory
Aliases:

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

-NewName

Ange ett nytt namn för att byta namn på frågan.

Type: String
Parameter Sets: (All)
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 denna cmdlet kanske inte några utdata.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-TargetClassName

Ange namnet på den objektklass som du vill att frågan ska returnera. Det finns många objekttyper. I följande tabell visas flera vanliga klassnamn med beskrivningen från Konfigurationshanteraren konsolen:

Klassnamn	Description
SMS_R_System	Systemresurs
SMS_Program	Program
SMS_R_UserGroup	Resurs för användargrupp
SMS_R_User	Användarresurs
SMS_SiteAndSubsites	Plats och underplatser
SMS_R_UnknownSystem	Okänd dator

Type: String
Parameter Sets: (All)
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: None
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

RELATED LINKS

Export-CMQuery Get-CMQuery Import-CMQuery Invoke-CMQuery New-CMQuery Remove-CMQuery Introduktion till frågor i Konfigurationshanteraren