New-CMQuery

SYNOPSIS

Hozzon létre egy Konfigurációkezelő lekérdezést.

SYNTAX

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

DESCRIPTION

Ezzel a parancsmag használatával hozhat létre lekérdezést a Konfigurációkezelő.

Konfigurációkezelő lekérdezések egy WMI Query Language (WQL) kifejezést határoznak meg, amely a megadott feltételek alapján információkat szerez be a helyadatbázisból. A WQL hasonló az SQL, de továbbra is a SMS Provider az adatbázis helyett. Így a WQL továbbra is betartja a szerepköralapú hozzáférési konfigurációt.

A lekérdezések visszaadhatják a legtöbb 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ő.

Alapértelmezés szerint a Konfigurációkezelő több lekérdezést is tartalmaz. A Get-CMQuery parancsmag használatával áttekintheti az alapértelmezett lekérdezéseket. További példák WQL-kifejezésekre: Példa WQL-lekérdezésekre.

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: Új lekérdezés létrehozása egy adott verziójú kiszolgálókhoz

Ez a példa egy új, Server 2016 nevű lekérdezést hoz létre, amely olyan ügyfeleket keres, amelyek az operációs rendszer feliratával kezdődik, és a Microsoft Windows Server 2012. A következő három tulajdonságot adja vissza: Név, Utolsó bejelentkezési felhasználónév és Operációs rendszer felirata.

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"

2. példa: Lekérdezés létrehozása asztali eszközökhöz

Ez a példa egy asztali eszközök nevű új lekérdezést hoz létre, amely olyan eszközöket keres, amelyek a Rendszerház osztály Háztípusok tulajdonságához megadott értékeket tartalmaznak. Több tulajdonságot ad vissza, és egy adott gyűjtemény korlátozza.

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

-Comment (Megjegyzés)

Adjon meg egy nem kötelező megjegyzést a lekérdezés további azonosításához a webhelyen.

Type: String
Parameter Sets: (All)
Aliases:

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

-Expression (Kifejezés)

Adja meg a WQL-utasítást, amely meghatározza az eredményekben megjelenítendő attribútumokat, valamint az eredmények korlátozására vonatkozó feltételeket.

A WQL-utasítások gyakran tartalmaznak dupla idézőjelet ( ), ezért a paraméter értékét állítsa be aposztrófok () közé zárt " ' sztringként.

További példákért lásd: Példa WQL-lekérdezésekre.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
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 használatával.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-LimitToCollectionId

Adja meg, hogyan konfigurálja a gyűjteménykorlátozást ehhez a lekérdezéshez:

• Nincs korlátozva gyűjtemény: Állítsa a paraméter értékét üres sztringre ( "" ). Ne használja a $null beépített változót.
• Gyűjtemény korlátozása: Adja meg egy gyűjtemény azonosítóját. Például a "SMSDM003" Minden asztali és kiszolgálói ügyfél gyűjteményhez.
• Rákérdezés a gyűjteményre: Állítsa a paraméter értékét "<Prompt>" értékre.

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 lekérdezés nevét.

Type: String
Parameter Sets: (All)
Aliases:

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

-TargetClassName

Adja meg annak az objektumosztálynak a nevét, amit a lekérdezésnek vissza kell adnia. Számos objektumtípus létezik. Az alábbi táblázatban számos gyakori osztálynév található a konzolon Konfigurációkezelő leírással:

Osztály neve	Description
SMS_R_System	Rendszererőforrás
SMS_Program	Program
SMS_R_UserGroup	Felhasználói csoport erőforrása
SMS_R_User	Felhasználói erőforrás
SMS_SiteAndSubsites	Hely és alwebhelyek
SMS_R_UnknownSystem	Ismeretlen számítógép

Type: String
Parameter Sets: (All)
Aliases:

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

None

OUTPUTS

IResultObject#SMS_Query

MEGJEGYZÉSEK

RELATED LINKS

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