Set-CMQuery

SYNOPSIS

Configuration Manager bir sorgu yapılandırın.

SYNTAX

Searchbyvaluezorunlu (varsayılan)

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

Searchbyıdzorunlu

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

Searchbynamezorunlu

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

DESCRIPTION

Configuration Manager bir sorgu yapılandırmak için bu cmdlet 'i kullanın. Configuration Manager sorguları, sağladığınız ölçütlere göre site veritabanından bilgi almak için bir WMI Sorgu Dili (WQL) ifadesi tanımlar. WQL SQL benzerdir, ancak yine de doğrudan veritabanına değil SMS sağlayıcısından geçer. Bu nedenle, WQL hala rol tabanlı erişim yapılandırmanızla uyumlu değildir.

Sorgular bilgisayarlar, siteler, koleksiyonlar, uygulamalar ve envanter verileri dahil olmak üzere çoğu Configuration Manager nesne türünü döndürebilir. Daha fazla bilgi için bkz. Configuration Manager sorgulara giriş.

Varsayılan olarak, Configuration Manager birkaç sorgu içerir. Varsayılan sorguları gözden geçirmek için Get-CMQuery cmdlet 'ini kullanabilirsiniz. WQL ifadelerine daha fazla örnek için bkz. örnek wql sorguları.

Not

Örneğin, Configuration Manager site sürücüsünden Configuration Manager cmdlet 'lerini çalıştırın PS XYZ:\> . Daha fazla bilgi için başlarken bölümüne bakın.

EXAMPLES

Örnek 1: sorguyu yeniden adlandırma

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

Örnek 2: sorgu sınırlandırma bir koleksiyon isteyecek şekilde değiştirin

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

PARAMETERS

-Açıklama

Sitedeki sorguyu daha ayrıntılı bir şekilde tanımlamak için isteğe bağlı bir açıklama belirtin.

Type: String
Parameter Sets: (All)
Aliases:

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

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

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

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

-Disableyavaya Cardhandling

Bu parametre, joker karakterleri değişmez değer karakter değerleri olarak değerlendirir. Bunu Forceyavaya Cardhandling ile birleştiremezsiniz.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-İfadesi

Sonuçlarda görüntülenecek öznitelikleri ve sonuçları sınırlayan ölçütü tanımlayan WQL ifadesini belirtin.

WQL deyimleri genellikle çift tırnak işaretleri ( " ) içerir, bu nedenle bu parametrenin değerini tek tırnak işaretleri () içine alınmış bir dize olarak ayarlayın ' .

Daha fazla örnek için bkz. örnek wql sorguları.

Type: String
Parameter Sets: (All)
Aliases:

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

-Forcebir Cardhandling

Bu parametre joker karakterleri işler ve beklenmeyen davranışlara neden olabilir (önerilmez). Bunu Disableyavaya Cardhandling ile birleştiremezsiniz.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ID

Yapılandırılacak sorgunun KIMLIĞINI belirtin. Örneğin, "XYZ00006".

Type: String
Parameter Sets: SearchByIdMandatory
Aliases: QueryId

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

-InputObject

Yapılandırılacak bir sorgu nesnesi belirtin. Bu nesneyi almak için Get-CMQuery cmdlet 'ini kullanın.

Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases:

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

-LimitToCollectionID

Bu sorgu için koleksiyon sınırlandırmasının nasıl yapılandırılacağını belirtin:

• Koleksiyon sınırlı değil: Bu parametrenin değerini boş bir dize () olarak ayarlayın "" . $nullYerleşik değişkeni kullanmayın.
• Koleksiyonla sınırla: BIR koleksiyonun kimliğini belirtin. Örneğin, "SMSDM003" tüm masaüstü ve sunucu istemcileri koleksiyonu için.
• Koleksiyon Için sor: Bu parametrenin değerini olarak ayarlayın "<Prompt>" .

Type: String
Parameter Sets: (All)
Aliases:

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

-Name

Yapılandırılacak sorgunun adını belirtin.

Type: String
Parameter Sets: SearchByNameMandatory
Aliases:

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

-YeniAd

Sorguyu yeniden adlandırmak için yeni bir ad belirtin.

Type: String
Parameter Sets: (All)
Aliases:

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

-Geçiş

Bu parametreyi, çalışmakta olduğunuz öğeyi temsil eden bir nesneyi döndürecek şekilde ekleyin. Varsayılan olarak, bu cmdlet herhangi bir çıktı üretmeyebilir.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-TargetClassName

Sorgunun döndürmesini istediğiniz nesne sınıfının adını belirtin. Birçok nesne türü mevcuttur. Aşağıdaki tabloda, Configuration Manager konsolundan açıklama içeren birkaç ortak sınıf adı listelenmektedir:

Sınıf adı	Description
SMS_R_System	Sistem kaynağı
SMS_Program	Program
SMS_R_UserGroup	Kullanıcı grubu kaynağı
SMS_R_User	Kullanıcı kaynağı
SMS_SiteAndSubsites	Site ve alt siteler
SMS_R_UnknownSystem	Bilinmeyen bilgisayar

Type: String
Parameter Sets: (All)
Aliases:

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

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

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

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

CommonParameters

Bu cmdlet şu genel parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement. ManagementProvider. ıresultobject

OUTPUTS

System.Object

NOTLAR

RELATED LINKS

Export-CMQuery Get-CMQuery Import-CMQuery Invoke-CMQuery New-CMQuery Remove-CMQuery Configuration Manager sorgulara giriş