New-CMQuery

SYNOPSIS

Configuration Manager sorgusu oluşturun.

SYNTAX

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

DESCRIPTION

Configuration Manager bir sorgu oluşturmak 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: belirli bir sürümdeki sunucular için yeni bir sorgu oluşturma

Bu örnek, Microsoft Windows Server 2012 ile başlayan işletim sistemi açıklamalı alt yazı ile Istemcileri arayan sunucu 2016 adlı yeni bir sorgu oluşturur. Şu üç özelliği döndürür: ad, son oturum açma Kullanıcı adı ve işletim sistemi başlığı.

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"

Örnek 2: masaüstü cihazlar için sorgu oluşturma

Bu örnek, sistem kasası sınıfının kasa türleri özelliği için belirli değerlere sahip cihazları arayan masaüstü cihazlar adlı yeni bir sorgu oluşturur. Birden çok özellik döndürür ve belirli bir koleksiyon tarafından sınırlandırılır.

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

-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: True
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

-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

Sorgunun adını belirtin.

Type: String
Parameter Sets: (All)
Aliases:

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

Hiçbiri

OUTPUTS

Iresultobject # SMS_Query

NOTLAR

RELATED LINKS

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