Set-CMQuery

SYNOPSIS

Configureer een Configuration Manager query.

SYNTAX

SearchByValueMandatory (standaard)

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

Gebruik deze cmdlet om een query te configureren in Configuration Manager. Configuration Manager query's definiëren een WMI Query Language (WQL)-expressie om informatie op te halen uit de sitedatabase op basis van de criteria die u opvraagt. WQL is vergelijkbaar met SQL, maar gaat nog steeds via de SMS-provider in plaats van rechtstreeks naar de database. WQL houdt zich dus nog steeds aan uw op rollen gebaseerde toegangsconfiguratie.

Query's kunnen de meeste typen Configuration Manager, waaronder computers, sites, verzamelingen, toepassingen en inventarisgegevens. Zie Inleiding tot query's in Configuration Manager voor meer Configuration Manager.

Standaard bevat Configuration Manager verschillende query's. U kunt de cmdlet Get-CMQuery gebruiken om de standaardquery's te controleren. Zie Voorbeeld van WQL-query's voor meer voorbeelden van WQL-expressies.

Notitie

Voer Configuration Manager cmdlets uit vanaf Configuration Manager sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.

EXAMPLES

Voorbeeld 1: De naam van een query wijzigen

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

Voorbeeld 2: de query wijzigen om te vragen om een beperkende verzameling

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

PARAMETERS

-Opmerking

Geef een optionele opmerking op om de query in de site verder te identificeren.

Type: String
Parameter Sets: (All)
Aliases:

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

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

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

-DisableWildcardHandling

Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Expressie

Geef de WQL-instructie op die de kenmerken definieert die moeten worden weergegeven in de resultaten en de criteria om de resultaten te beperken.

WQL-instructies bevatten vaak dubbele aanhalingstekens ( ), dus stel de waarde van deze parameter in als een tekenreeks " tussen enkele aanhalingstekens ( ' ).

Zie Voorbeeld van WQL-query's voor meer voorbeelden.

Type: String
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag (niet aanbevolen). U kunt deze niet combineren met DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Id

Geef de id op van de query die u wilt configureren. Bijvoorbeeld "XYZ00006".

Type: String
Parameter Sets: SearchByIdMandatory
Aliases: QueryId

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

-InputObject

Geef een queryobject op dat u wilt configureren. Gebruik de cmdlet Get-CMQuery om dit object op te halen.

Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases:

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

-LimitToCollectionId

Geef op hoe u verzamelingsbeperking configureert voor deze query:

• Niet beperkt tot verzameling: stel de waarde van deze parameter in op een lege tekenreeks ( "" ). Gebruik niet de $null ingebouwde variabele .
• Beperken tot verzameling: geef de id van een verzameling op. Bijvoorbeeld voor "SMSDM003" de verzameling Alle bureaublad- en servercl clients.
• Vragen om verzameling: stel de waarde van deze parameter in op "<Prompt>" .

Type: String
Parameter Sets: (All)
Aliases:

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

-Name

Geef de naam op van de query die u wilt configureren.

Type: String
Parameter Sets: SearchByNameMandatory
Aliases:

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

-NewName

Geef een nieuwe naam op om de naam van de query te wijzigen.

Type: String
Parameter Sets: (All)
Aliases:

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

-PassThru

Voeg deze parameter toe om een -object te retourneren dat het item vertegenwoordigt waarmee u werkt. Standaard is het mogelijk dat deze cmdlet geen uitvoer genereert.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-TargetClassName

Geef de naam op van de objectklasse die u door de query wilt laten retourneren. Er zijn veel objecttypen beschikbaar. De volgende tabel bevat verschillende algemene klassenamen met de beschrijving van de Configuration Manager console:

Klassenaam	Description
SMS_R_System	Systeemresource
SMS_Program	Programma
SMS_R_UserGroup	Resource voor gebruikersgroep
SMS_R_User	Gebruikersresource
SMS_SiteAndSubsites	Site en subsites
SMS_R_UnknownSystem	Onbekende computer

Type: String
Parameter Sets: (All)
Aliases:

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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

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

CommonParameters

Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

OPMERKINGEN

RELATED LINKS

Export-CMQuery Get-CMQuery Import-CMQuery Invoke-CMQuery New-CMQuery Remove-CMQuery Inleiding tot query's in Configuration Manager