Set-CMQuery

SYNOPSIS

Konfigurálnia kell egy Konfigurációkezelő lekérdezést.

SYNTAX

SearchByValueMandatory (alapértelmezett)

Set-CMQuery [-Comment <String>] [-Expression <String>] -InputObject <IResultObject>
 [-LimitToCollectionId <String>] [-NewName <String>] [-PassThru] [-TargetClassName <String>]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchById Kötelező

Set-CMQuery [-Comment <String>] [-Expression <String>] -Id <String> [-LimitToCollectionId <String>]
 [-NewName <String>] [-PassThru] [-TargetClassName <String>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByName Kötelező

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

DESCRIPTION

Ezzel a parancsmag használatával konfigurálhat egy 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ó SQL, de továbbra SMS Provider az adatbázis helyett a teljes tartományon. A WQL tehát továbbra is betartja a szerepköralapú hozzáférési konfigurációt.

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ő.

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: Lekérdezés átnevezése

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

2. példa: A lekérdezés módosítása korlátozó gyűjtemény kéréséhez

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

PARAMETERS

-Comment (Megjegyzés)

Ha szükséges, adjon meg egy 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 idézőjelet ( ), ezért a paraméter értékét állítsa be sztringként, " aposztrófok között ( ' ).

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

Type: String
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

-Id (Azonosító)

Adja meg a konfigurálni 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 konfigurálni 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

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

• Nincs gyűjtemény korlátozva: A paraméter értékét állítsa ü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 konfigurálni 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

-NewName (Új név)

Adjon meg egy új nevet a lekérdezés átnevezéséhez.

Type: String
Parameter Sets: (All)
Aliases:

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

-PassThru

Adja hozzá ezt a paramétert, hogy visszaadja az objektumot, amely azt az elemet jelöli, amellyel dolgozik. Alapértelmezés szerint ez a parancsmag nem generál kimenetet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
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 érhető el. Az alábbi táblázat számos gyakori osztálynevet sorol fel a Konfigurációkezelő leírásával:

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

MEGJEGYZÉSEK

RELATED LINKS

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