Invoke-CMWmiQuery

SYNOPSIS

WMI-lekérdezés futtatása.

SYNTAX

ByWql (alapértelmezett)

Invoke-CMWmiQuery [-Context <Hashtable>] [-Option <QueryOptions>] [-Query] <String> [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

BySearch

Invoke-CMWmiQuery -ClassName <String> [-Context <Hashtable>] [-Option <QueryOptions>]
 -Search <SmsProviderSearch> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

DESCRIPTION

Az Invoke-CMWmiQuery parancsmag egy Windows Management Instrumentation (WMI) lekérdezést futtat. A többi lekérdezési parancsmagtól és eszköztől eltérően ezzel a parancsmaggal már be van állítva a kapcsolat és a névtér.

Ezzel a parancsmaggal lekérdezést is létrehozhat a WMI Query Language (WQL) használatával. Konfigurációkezelő WQL-t használ a gyűjteményekben lekérdezésekhez. A WQL hasonló a SQL, de továbbra is SMS Provider, így a szerepköralapú hozzáférés-vezérlésnek is megfelelő.

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: WQL-lekérdezés futtatása

Az első parancs létrehoz egy WQL-lekérdezést, és az $WQL tárolja. A második parancs a változóban tárolt lekérdezést futtatja.

$WQL = @"
SELECT app.* FROM SMS_ApplicationLatest AS app
INNER JOIN SMS_CIContentPackage AS con ON app.CI_ID=con.CI_ID
INNER JOIN SMS_DistributionPoint AS srv ON con.PackageID=srv.PackageID
WHERE app.IsHidden = 0
"@

Invoke-CMWmiQuery -Query $WQL -Option Lazy

2. példa: WMI-lekérdezés futtatása eszközgyűjtemények számára

Az első parancs létrehoz egy keresési objektumot, és az objektumot a $Search tárolja.

A második parancs megadja, hogy a keresési sorrend növekvő sorrendben van a CollectionID szerint.

A harmadik parancs keresési paramétereket ad hozzá a $Search objektumhoz. Ebben az esetben a lekérdezés eszközgyűjteményeket keres.

Az utolsó parancs a következőben tárolt lekérdezést $Search. A gyűjteményazonosító SMS_Collection osztályként adja meg a gyűjteményazonosítót.

$Search = [Microsoft.ConfigurationManagement.PowerShell.Provider.SmsProviderSearch]::new()
$Search.AddOrder("CollectionID", [Microsoft.ConfigurationManagement.PowerShell.Provider.SearchParameterOrderBy]::Asc)
$Search.Add("Name","DeviceCol*", $True)

Invoke-CMWmiQuery -Search $Search -ClassName "SMS_Collection" -Option Lazy

3. példa: WMI-lekérdezés futtatása helyeken állapot szerint

Az első parancs törli a keresési paramétereket a meglévő keresési objektumokból.

A második parancs keresési paramétereket ad hozzá a $Search objektumhoz. Ebben az esetben a lekérdezés webhelyekre keres rá.

Az utolsó parancs a következőben tárolt lekérdezést $Search. Megadja, SMS_Site a hely Állapot tulajdonságát tartalmazó osztály.

$Search.Clear()
$Search.Add("Status", $True)

Invoke-CMWmiQuery -ClassName "SMS_Site" -Search $Search

4. példa: WMI-lekérdezés futtatása helyekhez név alapján

Az első parancs törli a keresési paramétereket a meglévő keresési objektumokból.

A második parancs keresési paramétereket ad hozzá a $Search objektumhoz. Ebben az esetben a lekérdezés webhelyekre keres rá.

Az utolsó parancs a következőben tárolt lekérdezést $Search. Megadja a SMS_Site siteName tulajdonságot tartalmazó osztályként.

$Search.Clear()
$Search.Add("SiteName", $null, [Microsoft.ConfigurationManagement.PowerShell.Provider.SearchParameterOperator]::NotEquals)

Invoke-CMWmiQuery -ClassName "SMS_Site" -Search $Search

5. példa: WMI-lekérdezés futtatása alkalmazásokhoz

Az első parancs törli a keresési paramétereket a meglévő keresési objektumokból.

A második parancs keresési paramétereket ad hozzá a $Search objektumhoz. Ebben az esetben a lekérdezés alkalmazásokat keres.

Az utolsó parancs a következőben tárolt lekérdezést $Search. A hely SMS_Site tulajdonságot tartalmazó osztályként adja meg CI_ID osztályt.

$Search.Clear()
$Search.AddAdhoc("CI_ID > 0")

Invoke-CMWmiQuery -ClassName "SMS_Application" -Search $Search -Option Lazy

PARAMETERS

-ClassName

Megadja Konfigurációkezelő lekérdezni kívánt WMI-osztályt.

Type: String
Parameter Sets: BySearch
Aliases:

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

-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: False
Accept pipeline input: False
Accept wildcard characters: False

-Context (Környezet)

Adja meg a WMI-környezetet kivonattáblaként. Olyan név/érték párok listája, amelyek át vannak kabva egy WMI-szolgáltatónak, amely támogatja a testreszabott műveletek környezeti információit.

Type: Hashtable
Parameter Sets: (All)
Aliases:

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). Nem kombinálhatja a DisableWildcardHandling kártyával.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Option (Beállítás)

A leggyakoribb lehetőség a Fast .

Adjon meg egy lekérdezési lehetőséget:

• None: Alapértelmezett
• Lazy: Alapértelmezés szerint a parancsmag betölti a lusta tulajdonságokat.
• Fast: Ezzel a beállítással nem tölt be lusta tulajdonságokat. Ez a beállítás gyorsabban visszaadhat eredményeket egyes osztályokhoz.
• ExpectResults & ExpectResultsThrowException: Ha a lekérdezés nem ad vissza eredményt, kivételt ad vissza. Ez a kivétel általában véget ér egy szkriptnek.
• FastExpectResults & LazyExpectResults: Ezek a lehetőségek kombinálják a Fast és Lazy a et a ExpectResults következővel: .
• ExpectResultsSoftFail: Ha a lekérdezés nem ad vissza eredményt, hibát ad vissza, de ne adja ki a szkriptet.

A lusta tulajdonságokkal kapcsolatos további információkért lásd a Konfigurációkezelő tulajdonságokat.

A következő értékek csak belső használatra használhatók:

• Klónozás
• NoMask (Maszk mellőzve)
• NoRefresh
• IgnoreNoResults (Eredmény mellőzve)

Type: QueryOptions
Parameter Sets: (All)
Aliases: Options
Accepted values: None, NoRefresh, Lazy, Fast, ExpectResults, FastExpectResults, LazyExpectResults, Clone, ExpectResultsSoftFail, ExpectResultsThrowException, NoMask, IgnoreNoResults

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

-Query

Egy WMI Query Language (WQL) utasítást ad meg.

Type: String
Parameter Sets: ByWql
Aliases:

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

-Search

Egy SMSProviderSearch objektumot ad meg.

Type: SmsProviderSearch
Parameter Sets: BySearch
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: False
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

None

OUTPUTS

IResultObject[]

IResultObject

MEGJEGYZÉSEK

RELATED LINKS

Invoke-CMWmiMethod