New-CMQuery

  • Artikel

SYNOPSIS

Skapa en Konfigurationshanteraren fråga.

SYNTAX

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

DESCRIPTION

Använd den här cmdleten för att skapa en fråga 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 en SQL, men går fortfarande via SMS-providern i stället för direkt till databasen. WQL följer alltså fortfarande din rollbaserade åtkomstkonfiguration.

Frågor kan returnera de flesta typer av 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 platsenheten, till exempel PS XYZ:\> . Mer information finns i Komma igång.

EXAMPLES

Exempel 1: Skapa en ny fråga för servrar med en specifik version

I det här exemplet skapas en ny fråga med namnet Server 2016 som söker efter klienter med operativsystemsrubriken som börjar med Microsoft Windows Server 2012. Den returnerar följande tre egenskaper: Name (Namn), Last logon user name (Användarnamn för senaste inloggning) och UNDERtext för operativsystemet.

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"

Exempel 2: Skapa en fråga för stationära enheter

Det här exemplet skapar en ny fråga med namnet Desktop-enheter som söker efter enheter med specifika värden för egenskapen Chassityper för klassen System Enclosure. Den returnerar flera egenskaper och begränsas av en specifik samling.

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

-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

-Uttryck

Ange den WQL-instruktion som definierar de attribut 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: True
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

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

Type: String
Parameter Sets: (All)
Aliases:

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

Ingen

OUTPUTS

IResultObject#SMS_Query

ANTECKNINGAR

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