Set-CMQuery

SYNOPSIS

Skonfiguruj Menedżer konfiguracji zapytania.

SYNTAX

SearchByValueMandatory (ustawienie domyślne)

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

SearchByIdMandatory

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

SearchByNameMandatory

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

DESCRIPTION

To polecenie cmdlet umożliwia skonfigurowanie 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żna 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 Menedżer konfiguracji lokacji, na przykład PS XYZ:\> . Aby uzyskać więcej informacji, zobacz wprowadzenie.

EXAMPLES

Przykład 1: Zmiana nazwy zapytania

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

Przykład 2. Zmienianie zapytania w celu monitowania o ograniczenie kolekcji

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

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 literału znaków. 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

Wyrażenie -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: False
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

-Id (Identyfikator)

Określ identyfikator zapytania do skonfigurowania. Na przykład "XYZ00006".

Type: String
Parameter Sets: SearchByIdMandatory
Aliases: QueryId

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

-InputObject

Określ obiekt zapytania do skonfigurowania. Aby uzyskać ten obiekt, użyj polecenia cmdlet Get-CMQuery.

Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
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 do skonfigurowania.

Type: String
Parameter Sets: SearchByNameMandatory
Aliases:

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

-NewName

Określ nową nazwę, aby zmienić nazwę zapytania.

Type: String
Parameter Sets: (All)
Aliases:

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

-PassThru

Dodaj ten parametr, aby zwrócić obiekt reprezentujący element, z którym pracujesz. Domyślnie to polecenie cmdlet może nie generować żadnych danych wyjściowych.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

UWAGI

RELATED LINKS

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