Sdílet prostřednictvím


Set-CMQuery

SYNOPSIS

Konfigurace Správce konfigurace dotazu

SYNTAX

SearchByValueMandatory (výchozí)

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

Pomocí této rutiny můžete nakonfigurovat dotaz v Správce konfigurace. Správce konfigurace dotazy definují výraz jazyk WQL (WMI Query Language) (WQL) pro získání informací z databáze lokality na základě zadaných kritérií. Jazyk WQL je SQL, ale stále prochází přes poskytovatele serveru SMS místo přímo do databáze. Jazyk WQL se tedy stále uchová v konfiguraci přístupu na základě role.

Dotazy mohou vracet většinu typů objektů Správce konfigurace, mezi které patří počítače, lokality, kolekce, aplikace a data inventáře. Další informace najdete v tématu Úvod do dotazů v Správce konfigurace.

Ve výchozím nastavení Správce konfigurace několik dotazů. Ke kontrola výchozích dotazů můžete použít rutinu Get-CMQuery. Další příklady výrazů jazyka WQL najdete v tématu Příklady dotazů jazyka WQL.

Poznámka

Spusťte Správce konfigurace rutiny z Správce konfigurace lokality, například PS XYZ:\> . Další informace najdete v tématu Začínáme.

EXAMPLES

Příklad 1: Přejmenování dotazu

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

Příklad 2: Změna dotazu tak, aby se výzva k zadání limitující kolekce

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

PARAMETERS

-Comment

Zadejte volitelný komentář pro další identifikaci dotazu na webu.

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 za hodnoty literálových znaků. Nemůžete ho kombinovat s forceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Expression

Zadejte příkaz jazyka WQL, který definuje 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 najdete v tématu Příklady dotazů jazyka WQL.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
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čuje se). Nemůžete ho kombinovat s příkazem DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Id

Zadejte ID dotazu, který chcete nakonfigurovat. Například, "XYZ00006".

Type: String
Parameter Sets: SearchByIdMandatory
Aliases: QueryId

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

-InputObject

Zadejte objekt dotazu, který chcete nakonfigurovat. K získání tohoto objektu použijte rutinu 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

Určete, jak nakonfigurovat omezení kolekcí pro tento dotaz:

  • Není omezena kolekce: Nastavte hodnotu tohoto parametru na prázdný řetězec ( "" ). Nepoužívejte $null integrovanou proměnnou.
  • Limit to collection(Omezit na kolekci): Zadejte ID kolekce. Například pro "SMSDM003" kolekci Všichni klienti desktopových a serverových aplikací.
  • Vyzvat k zadání kolekce: 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, který chcete nakonfigurovat.

Type: String
Parameter Sets: SearchByNameMandatory
Aliases:

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

-NewName

Zadáním nového názvu dotaz přejmenujte.

Type: String
Parameter Sets: (All)
Aliases:

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

-PassThru

Přidáním tohoto parametru vrátíte objekt, který představuje položku, se kterou pracujete. Ve výchozím nastavení tato rutina nemusí generovat žádný výstup.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-TargetClassName

Zadejte název třídy objektu, kterou 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 Správce konfigurace tříd:

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 Lokality a podřízené lokality
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 nespouštěl.

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

POZNÁMKY

Export CMQuery Get-CMQuery Import CMQuery Vyvolání CMQuery New-CMQuery Odebrání CMQuery Úvod do dotazů v Správce konfigurace