Sdílet prostřednictvím

New-CMQuery

  • Článek

SYNOPSIS

Vytvořte dotaz Configuration Manager.

SYNTAX

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

DESCRIPTION

Pomocí této rutiny můžete vytvořit dotaz v Configuration Manager.

Configuration Manager dotazy definují výraz jazyka jazyk WQL (WMI Query Language) (WQL) pro získání informací z databáze lokality na základě zadaných kritérií. WQL je podobný SQL, ale stále prochází poskytovatelem serveru SMS namísto přímo k databázi. Takže jazyk WQL je stále společnost vaší konfigurací přístupu na základě role.

Dotazy mohou vracet většinu typů Configuration Manager objektů, které zahrnují počítače, weby, kolekce, aplikace a data inventáře. Další informace najdete v tématu Úvod do dotazů v Configuration Manager.

Ve výchozím nastavení Configuration Manager zahrnuje několik dotazů. Ke kontrole výchozích dotazů můžete použít rutinu Get-CMQuery . Další příklady výrazů jazyka WQL naleznete v tématu příklady dotazů WQL.

Poznámka

Použijte například rutiny Configuration Manager z Configuration Manager jednotky webu PS XYZ:\> . Další informace najdete v tématu Začínáme.

EXAMPLES

Příklad 1: vytvoření nového dotazu pro servery určité verze

Tento příklad vytvoří nový dotaz s názvem Server 2016 , který vyhledá klienty s POPISKEM operačního systému, který začíná na Microsoft Windows Server 2012. Vrátí následující tři vlastnosti: název, Poslední přihlašovací uživatelské jméno a popisek operačního systému.

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"

Příklad 2: vytvoření dotazu pro stolní zařízení

Tento příklad vytvoří nový dotaz nazvaný desktopová zařízení , který vyhledá zařízení s konkrétními hodnotami pro vlastnost skříní třídy skříně systému . Vrátí více vlastností a je omezen konkrétní kolekcí.

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

– Komentář

Zadejte volitelný komentář k dalšímu identifikaci dotazu v lokalitě.

Type: String
Parameter Sets: (All)
Aliases:

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

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

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

-DisableWildcardHandling

Tento parametr považuje zástupné znaky jako literálové hodnoty znaků. Nejde kombinovat s ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

– Výraz

Zadejte příkaz jazyka WQL definující atributy, které se mají zobrazit ve výsledcích a kritéria pro omezení výsledků.

Příkazy jazyka WQL často obsahují dvojité uvozovky ( " ), proto nastavte hodnotu tohoto parametru jako řetězec uzavřený v jednoduchých uvozovkách ( ' ).

Další příklady naleznete v tématu příklady dotazů jazyka WQL.

Type: String
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Tento parametr zpracovává zástupné znaky a může vést k neočekávanému chování (nedoporučujeme). Nejde kombinovat s DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-LimitToCollectionId

Určete, jak se má pro tento dotaz nakonfigurovat omezení kolekce:

  • Neomezeno na kolekci: nastavte hodnotu tohoto parametru na prázdný řetězec ( "" ). Nepoužívejte $null vestavěnou proměnnou.
  • Omezení na kolekci: Zadejte ID kolekce. Například "SMSDM003" pro kolekci všechny desktopové a serverové klienty .
  • Dotázat se na kolekci: nastavte hodnotu tohoto parametru na "<Prompt>" .
Type: String
Parameter Sets: (All)
Aliases:

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

-Name

Zadejte název dotazu.

Type: String
Parameter Sets: (All)
Aliases:

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

-TargetClassName

Zadejte název třídy objektu, který má dotaz vrátit. K dispozici je mnoho typů objektů. Následující tabulka uvádí několik běžných názvů tříd s popisem z konzoly Configuration Manager:

Název třídy Popis
SMS_R_System Systémový prostředek
SMS_Program Program
SMS_R_UserGroup Prostředek skupiny uživatelů
SMS_R_User Prostředek uživatele
SMS_SiteAndSubsites Lokalita a podřízené weby
SMS_R_UnknownSystem Neznámý počítač 
Type: String
Parameter Sets: (All)
Aliases:

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina se nespustí.

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

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

CommonParameters

Tato rutina podporuje společné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v tématu about_CommonParameters.

INPUTS

Žádná

OUTPUTS

IResultObject # SMS_Query

POZNÁMKY

Export – CMQuery Get-CMQuery Import – CMQuery Invoke – CMQuery Remove-CMQuery Set-CMQuery Seznámení s dotazy v Configuration Manager