New-CMQuery

  • Artykuł

SYNOPSIS

Utwórz Menedżer konfiguracji zapytania.

SYNTAX

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

DESCRIPTION

To polecenie cmdlet umożliwia utworzenie zapytania w Menedżer konfiguracji.

Menedżer konfiguracji definiują wyrażenie język zapytań usługi WMI (WQL) w celu uzyskania informacji z bazy danych lokacji na podstawie określonych kryteriów. WQL jest podobny do SQL, ale nadal przechodzi przez dostawcę programu SMS zamiast bezpośrednio do bazy danych. Dlatego WQL nadal przestrzega konfiguracji dostępu opartej na rolach.

Zapytania mogą zwracać większość typów obiektów Menedżer konfiguracji, w tym komputery, lokacje, kolekcje, aplikacje i dane spisu. Aby uzyskać więcej informacji, zobacz Wprowadzenie do zapytań w Menedżer konfiguracji.

Domyślnie program Menedżer konfiguracji kilka zapytań. Aby przejrzeć zapytania domyślne, możesz użyć polecenia cmdlet Get-CMQuery. Aby uzyskać więcej przykładów wyrażeń WQL, zobacz Przykładowe zapytania WQL.

Uwaga

Uruchom Menedżer konfiguracji cmdlet z dysku Menedżer konfiguracji lokacji, na przykład PS XYZ:\> . Aby uzyskać więcej informacji, zobacz wprowadzenie.

EXAMPLES

Przykład 1: tworzenie nowego zapytania dla serwerów w określonej wersji

W tym przykładzie jest wyświetlane nowe zapytanie o nazwie Server 2016, które wyszukuje klientów z podpisem systemu operacyjnego, który rozpoczyna się od ciągu Microsoft Windows Server 2012. Zwraca trzy następujące właściwości: Name (Nazwa), Last logon user name (Ostatnia nazwa użytkownika logowania) i OS caption (Podpis systemu operacyjnego).

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"

Przykład 2: tworzenie zapytania dla urządzeń stacjonarnych

Ten przykład tworzy nowe zapytanie o nazwie Urządzenia stacjonarne, które wyszukuje urządzenia z określonymi wartościami właściwości Typy obudowy klasy Obudowa systemowa. Zwraca wiele właściwości i jest ograniczony przez określoną kolekcję.

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

-Komentarz

Określ opcjonalny komentarz, aby dodatkowo zidentyfikować zapytanie w witrynie.

Type: String
Parameter Sets: (All)
Aliases:

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

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

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

-DisableWildcardHandling

Ten parametr traktuje symbole wieloznaczne jako wartości znaków literału. Nie można połączyć go z forceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Expression

Określ instrukcje WQL definiujące atrybuty do wyświetlenia w wynikach oraz kryteria ograniczające wyniki.

Instrukcje WQL często zawierają podwójne cudzysłowy ( ), więc ustaw wartość tego parametru jako ciąg ujęty w " pojedynczy cudzysłów ( ' ).

Aby uzyskać więcej przykładów, zobacz Przykładowe zapytania WQL.

Type: String
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Ten parametr przetwarza symbole wieloznaczne i może prowadzić do nieoczekiwanego zachowania (nie jest zalecane). Nie można połączyć go z disableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-LimitToCollectionId

Określ sposób konfigurowania ograniczania kolekcji dla tego zapytania:

  • Nie ograniczono kolekcji: ustaw wartość tego parametru na pusty ciąg ( "" ). Nie używaj $null wbudowanej zmiennej .
  • Ogranicz do kolekcji: określ identyfikator kolekcji. Na przykład "SMSDM003" dla kolekcji Wszyscy klienci pulpitu i serwera.
  • Monituj o kolekcję: ustaw wartość tego parametru na "<Prompt>" .
Type: String
Parameter Sets: (All)
Aliases:

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

-Name

Określ nazwę zapytania.

Type: String
Parameter Sets: (All)
Aliases:

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

-TargetClassName

Określ nazwę klasy obiektu, która ma zostać zwrócona przez zapytanie. Dostępnych jest wiele typów obiektów. W poniższej tabeli wymieniono kilka typowych nazw klas z opisem z Menedżer konfiguracji konsoli:

Nazwa klasy Opis
SMS_R_System Zasób systemowy
SMS_Program Program
SMS_R_UserGroup Zasób grupy użytkowników
SMS_R_User Zasób użytkownika
SMS_SiteAndSubsites Lokacja i lokacje podrzędne
SMS_R_UnknownSystem Nieznany komputer 
Type: String
Parameter Sets: (All)
Aliases:

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie jest uruchamiane.

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

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

Typowe parametry

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

INPUTS

Brak

OUTPUTS

IResultObject#SMS_Query

UWAGI

Export-CMQuery Get-CMQuery Import-CMQuery Invoke-CMQuery Remove-CMQuery Set-CMQuery Wprowadzenie do zapytań w Menedżer konfiguracji