Set-CMQuery

Modulo:

ConfigurationManager

Configurare una query di Configuration Manager.

Sintassi

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

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

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

Descrizione

Utilizzare questo cmdlet per configurare una query in Configuration Manager. Le query di Configuration Manager definiscono un'espressione WQL (WMI Query Language) per ottenere informazioni dal database del sito in base ai criteri specificati. WQL è simile a SQL, ma passa comunque attraverso il provider SMS anziché direttamente al database. Quindi WQL è ancora abides dalla configurazione dell'accesso basato sui ruoli.

Le query possono restituire la maggior parte dei tipi di oggetti di Configuration Manager, che includono computer, siti, raccolte, applicazioni e dati di inventario. Per ulteriori informazioni, vedere Introduzione alle query in Configuration Manager.

Per impostazione predefinita, Configuration Manager include diverse query. È possibile utilizzare il cmdlet Get-CMQuery per esaminare le query predefinite. Per ulteriori esempi di espressioni WQL, vedere Query WQL di esempio.

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\> . Per ulteriori informazioni, vedere Introduzione.

Esempio

Esempio 1: Rinominare una query

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

Esempio 2: Modificare la query per richiedere una raccolta di limitazione

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

Parametri

-Comment

Specificare un commento facoltativo per identificare ulteriormente la query nel sito.

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

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

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

-Expression

Specificare l'istruzione WQL che definisce gli attributi da visualizzare nei risultati e i criteri per limitare i risultati.

Le istruzioni WQL spesso includono virgolette doppie ( ), quindi impostare il valore di questo parametro come stringa racchiusa " tra virgolette singole ( ' ).

Per altri esempi, vedere Query WQL di esempio.

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

-ForceWildcardHandling

Questo parametro elabora i caratteri jolly e può causare un comportamento imprevisto (scelta non consigliata). Non è possibile combinarlo con DisableWildcardHandling.

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

-Id

Specificare l'ID della query da configurare. Ad esempio, "XYZ00006".

Type:	String
Aliases:	QueryId
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Specificare un oggetto query da configurare. Per ottenere questo oggetto, utilizzare il cmdlet Get-CMQuery.

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

-LimitToCollectionId

Specificare come configurare la limitazione delle raccolte per questa query:

• Non limitato alla raccolta: impostare il valore di questo parametro su una stringa vuota ( "" ). Non usare la $null variabile incorporata.
• Limite alla raccolta: specificare l'ID di una raccolta. Ad esempio, "SMSDM003" per l'insieme All Desktop and Server Clients.
• Richiedi raccolta: impostare il valore di questo parametro su "<Prompt>" .

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

-Name

Specificare il nome della query da configurare.

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

-NewName

Specificare un nuovo nome per rinominare la query.

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

-PassThru

Aggiungere questo parametro per restituire un oggetto che rappresenta l'elemento con cui si sta lavorando. Per impostazione predefinita, questo cmdlet potrebbe non generare alcun output.

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

-TargetClassName

Specificare il nome della classe di oggetti che si desidera restituire dalla query. Sono disponibili molti tipi di oggetti. Nella tabella seguente sono elencati diversi nomi di classe comuni con la descrizione dalla console di Configuration Manager:

Nome classe	Descrizione
SMS_R_System	Risorsa di sistema
SMS_Program	Programma
SMS_R_UserGroup	Risorsa gruppo utenti
SMS_R_User	Risorsa utente
SMS_SiteAndSubsites	Siti e siti secondari
SMS_R_UnknownSystem	Computer sconosciuto

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

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object

Collegamenti correlati

• Export-CMQuery
• Get-CMQuery
• Import-CMQuery
• Invoke-CMQuery
• New-CMQuery
• Remove-CMQuery
• Introduzione alle query in Configuration Manager