Megosztás a következőn keresztül:

Invoke-CMQuery

  • Cikk

SYNOPSIS

Futtason Konfigurációkezelő lekérdezést.

SYNTAX

SearchByValueMandatory (alapértelmezett)

Invoke-CMQuery -InputObject <IResultObject> [-LimitToCollectionId <String>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchById Kötelező

Invoke-CMQuery -Id <String> [-LimitToCollectionId <String>] [-DisableWildcardHandling] [-ForceWildcardHandling]
 [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByName Kötelező

Invoke-CMQuery [-LimitToCollectionId <String>] -Name <String> [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Ezzel a parancsmag használatával futtathat lekérdezést a Konfigurációkezelő helyen. Konfigurációkezelő lekérdezések meghatároznak egy WMI Query Language (WQL) kifejezést, amely a megadott feltételek alapján információkat szerez be a helyadatbázisból. A WQL hasonló a SQL, de továbbra is a SMS Provider halad át közvetlenül az adatbázis helyett. A WQL tehát továbbra is betartja a szerepköralapú hozzáférési konfigurációt.

Lekérdezés futtatásakor a hely feldolgozza a WQL-kifejezést, és visszaadja az eredményeket a PowerShellben. A WQL-utasítás struktúrájától függően az eredmények formátuma eltérő lehet.

A lekérdezések a legtöbb objektumtípust Konfigurációkezelő, például számítógépeket, helyeket, gyűjteményeket, alkalmazásokat és leltáradatokat. További információ: Bevezetés a lekérdezések Konfigurációkezelő.

Megjegyzés

Futtassa Konfigurációkezelő parancsmagokat a Konfigurációkezelő hely meghajtóról, például: PS XYZ:\> . További információ: Első lépések.

EXAMPLES

1. példa: Alapértelmezett lekérdezés megtekintése és futtatása

Ez a példa először a Get-CMQuery parancsmagot mutatja be, amely megjeleníti az alapértelmezett lekérdezés( Ez a hely és annak alwebhelyei) tulajdonságait.

Ezután megjeleníti az Invoke-CMQuery parancsmagot, amely ugyanezt a lekérdezést futtatja, és megjeleníti az eredményeket.

PS XYZ:\> Get-CMQuery -Id "SMS012"

SmsProviderObjectPath          : SMS_Query.QueryID="SMS012"
Comments                       : This site and all its subsites in the ConfigMgr hierarchy
Expression                     : SELECT SiteCode, SiteName, Version, ServerName FROM sms_siteandsubsites
LimitToCollectionID            :
LocalizedCategoryInstanceNames : {}
Name                           : This Site and its Subsites
QueryID                        : SMS012
ResultAliasNames               : {sms_siteandsubsites, sms_siteandsubsites, sms_siteandsubsites, sms_siteandsubsites}
ResultColumnsNames             : {sms_siteandsubsites.SiteCode, sms_siteandsubsites.SiteName,
                                 sms_siteandsubsites.Version, sms_siteandsubsites.ServerName}
TargetClassName                : sms_siteandsubsites

PS XYZ:\> Invoke-CMQuery -Id "SMS012"

SmsProviderObjectPath : SMS_SiteAndSubsites.SiteCode="XYZ"
ServerName            : cmserver.contoso.com
SiteCode              : XYZ
SiteName              : Production primary site
Version               : 5.00.9043.1000

A Get-CMQuery parancsmag kimenetében figyelje meg, hogy a WQL-kifejezés egyszerű. Négy attribútumot választ ki egyetlen osztályból.

Ezután figyelje meg, hogy az Invoke-CMQuery parancsmag kimenete egy egyszerű tábla.

2. példa: Összetett lekérdezés megtekintése és futtatása

Ez a példa először a Get-CMQuery parancsmagot mutatja be, amely egy egyéni lekérdezés tulajdonságait mutatja be.

Ezután megjeleníti az Invoke-CMQuery parancsmagot, amely ugyanezt a lekérdezést futtatja, és megjeleníti az eredményeket.

PS XYZ:\> Get-CMQuery -Id "XYZ00002"

SmsProviderObjectPath          : SMS_Query.QueryID="XYZ00002"
Comments                       :
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%"
LimitToCollectionID            : XYZ0025F
LocalizedCategoryInstanceNames : {}
Name                           : Server 2016
QueryID                        : XYZ00002
ResultAliasNames               : {SMS_R_System, SMS_R_System, SMS_G_System_OPERATING_SYSTEM}
ResultColumnsNames             : {SMS_R_System.Name, SMS_R_System.LastLogonUserName,
                                 SMS_G_System_OPERATING_SYSTEM.Caption}
TargetClassName                : SMS_R_System

PS XYZ:\> Invoke-CMQuery -Id "XYZ00002"


SmsProviderObjectPath         : __GENERIC
SMS_G_System_OPERATING_SYSTEM :
                                instance of SMS_G_System_OPERATING_SYSTEM
                                {
                                        Caption = "Microsoft Windows Server 2012 R2 Datacenter";
                                };

SMS_R_System                  :
                                instance of SMS_R_System
                                {
                                        LastLogonUserName = "jqpublic";
                                        Name = "millcreek01";
                                };

Ez a lekérdezés egy összetettebb kifejezéssel rendelkezik, amely két osztályt egyesül. A lekérdezés eredménye ekkor összetettebb lesz.

PARAMETERS

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

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

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

-DisableWildcardHandling

Ez a paraméter literál karakterértékekként kezeli a helyettesítő karaktereket. Nem kombinálhatja a ForceWildcardHandling használatával.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Ez a paraméter feldolgozza a helyettesítő karaktereket, és váratlan viselkedéshez vezethet (nem ajánlott). A DisableWildcardHandling használatával nem kombinálható.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Id (Azonosító)

Adja meg a futtatni kívánt lekérdezés azonosítóját. Például: "XYZ00006".

Type: String
Parameter Sets: SearchByIdMandatory
Aliases: QueryId

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

-InputObject

Adjon meg egy futtatni kívánt lekérdezési objektumot. Az objektum lekérdezhető a Get-CMQuery parancsmag használatával.

Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases:

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

-LimitToCollectionId

Ha a lekérdezés úgy van konfigurálva, hogy rákérdez a korlátozó gyűjteményre, ezzel a paraméterrel adhatja meg a gyűjtemény azonosítóját. Ha a lekérdezés LimitToCollectionID tulajdonsága , és nem veszi fel ezt a paramétert a lekérdezés futtatásakor, a parancsmag futtatása <Prompt> sikertelen lesz.

Type: String
Parameter Sets: (All)
Aliases:

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

-Name

Adja meg a futtatni kívánt lekérdezés nevét.

Type: String
Parameter Sets: SearchByNameMandatory
Aliases:

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

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

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

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

CommonParameters

Ez a parancsmag a következő általános paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction és -WarningVariable. További információ: about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

MEGJEGYZÉSEK

Export-CMQuery Get-CMQuery Import-CMQuery New-CMQuery Remove-CMQuery Set-CMQuery Bevezetés a lekérdezések Konfigurációkezelő