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