Delen via

New-CMQuery

  • Artikel

SYNOPSIS

Maak een Configuration Manager query.

SYNTAX

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

DESCRIPTION

Gebruik deze cmdlet om een query te maken in Configuration Manager.

Configuration Manager query's definiëren een WMI Query Language -expressie (WQL) 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.

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: Een nieuwe query maken voor servers van een specifieke versie

In dit voorbeeld wordt een nieuwe query met de naam Server 2016 gemaakt die zoekt naar clients met het besturingssysteembijschrift dat begint met Microsoft Windows Server 2012. Deze retourneert de volgende drie eigenschappen: Naam, Gebruikersnaam voor laatste aanmelding en Bijschrift van het besturingssysteem.

New-CMQuery -Name "Server 2016" -Expression 'select SMS_R_System.Name, SMS_R_System.LastLogonUserName, SMS_G_System_OPERATING_SYSTEM.Caption from SMS_R_System inner join SMS_G_System_OPERATING_SYSTEM on SMS_G_System_OPERATING_SYSTEM.ResourceID = SMS_R_System.ResourceId where SMS_G_System_OPERATING_SYSTEM.Caption like "Microsoft Windows Server 2012%"' -TargetClassName "SMS_R_System" -LimitToCollectionId "SMS00001"

Voorbeeld 2: Een query maken voor desktopapparaten

In dit voorbeeld wordt een nieuwe query gemaakt met de naam Desktop-apparaten die zoeken naar apparaten met specifieke waarden voor de eigenschap Chassistypen van de klasse Systeembehuizing. Het retourneert meerdere eigenschappen en wordt beperkt door een specifieke verzameling.

New-CMQuery -Name "Desktop devices" -Expression 'select SMS_R_SYSTEM.ResourceID,SMS_R_SYSTEM.ResourceType,SMS_R_SYSTEM.Name,SMS_R_SYSTEM.SMSUniqueIdentifier,SMS_R_SYSTEM.ResourceDomainORWorkgroup,SMS_R_SYSTEM.Client from SMS_R_System inner join SMS_G_System_SYSTEM_ENCLOSURE on SMS_G_System_SYSTEM_ENCLOSURE.ResourceID = SMS_R_System.ResourceId where SMS_G_System_SYSTEM_ENCLOSURE.ChassisTypes in ( "3", "4", "5","6", "7", "15","16")' -TargetClassName "SMS_R_System" -LimitToCollectionId "XYZ000049"

PARAMETERS

-Opmerking

Geef een optionele opmerking op om de query op 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: True
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

-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 de ingebouwde $null variabele niet.
  • 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 van de query op.

Type: String
Parameter Sets: (All)
Aliases:

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

Geen

OUTPUTS

IResultObject#SMS_Query

OPMERKINGEN

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