Add-CMDeviceCollectionQueryMembershipRule
Aggiungere una regola di appartenenza alla query a una raccolta di dispositivi.
Sintassi
Add-CMDeviceCollectionQueryMembershipRule
-CollectionId <String>
[-PassThru]
-QueryExpression <String>
-RuleName <String>
[-ValidateQueryHasResult]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMDeviceCollectionQueryMembershipRule
-CollectionName <String>
[-PassThru]
-QueryExpression <String>
-RuleName <String>
[-ValidateQueryHasResult]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMDeviceCollectionQueryMembershipRule
-InputObject <IResultObject>
[-PassThru]
-QueryExpression <String>
-RuleName <String>
[-ValidateQueryHasResult]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Utilizzare questo cmdlet per aggiungere una regola di appartenenza di query a una raccolta di dispositivi.
Una regola di query consente di aggiornare in modo dinamico l'appartenenza di una raccolta in base a una query eseguita in base a una pianificazione.
Non è possibile aggiungere regole di appartenenza alle raccolte predefinite. Qualsiasi raccolta di destinazione deve avere un ID che inizia con il codice del sito, non SMS
.
Per ulteriori informazioni, vedere Come creare raccolte in Configuration Manager.
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: Aggiungere una regola di appartenenza alla query
In questo esempio l'istruzione WQL (WMI Query Language) viene innanzitutto archiviata nella variabile wql. Il comando successivo aggiunge una regola di appartenenza denominata TPM alla raccolta di dispositivi denominata Windows 10 dispositivi. Il parametro QueryExpression utilizza la variabile wql e specifica la query che definisce la regola di appartenenza.
$wql = "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_TPM on SMS_G_System_TPM.ResourceID = SMS_R_System.ResourceId"
Add-CMDeviceCollectionQueryMembershipRule -CollectionName "Windows 10 devices" -QueryExpression $wql -RuleName "TPM"
Parametri
-CollectionId
Specifica l'ID della raccolta di dispositivi per aggiungere la regola. Questo valore è la proprietà CollectionID, ad esempio XYZ00012
. Poiché non è possibile aggiungere regole di appartenenza alle raccolte predefinite, questo ID inizia con il codice del sito e non con SMS
.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
Specifica il nome della raccolta di dispositivi per aggiungere la regola.
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: | False |
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 |
-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 |
-InputObject
Specificare un oggetto per l'insieme di dispositivi per aggiungere la regola. Per ottenere questo oggetto, utilizzare i cmdlet Get-CMCollection o Get-CMDeviceCollection.
Type: | IResultObject |
Aliases: | Collection |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
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 |
-QueryExpression
Specificare l'espressione WQL (WMI Query Language) utilizzata dal sito per aggiornare la raccolta di dispositivi.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RuleName
Specificare il nome della regola di query da aggiungere alla raccolta.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ValidateQueryHasResult
Aggiungere questo parametro per testare l'espressione di query prima di aggiungere la regola. Quando il cmdlet viene eseguito con questo parametro, se l'espressione di query non ha risultati, il cmdlet restituisce il messaggio di errore seguente: In questo caso, la query non viene aggiunta No object corresponds to the specified parameters.
all'insieme.
Se si è a sapere che la query attualmente restituisce zero risultati, ma si desidera comunque aggiungere la regola, non utilizzare questo parametro.
Type: | SwitchParameter |
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: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Input
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Output
System.Object