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
""
.$null
Yerleş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ş