Remove-CMCollectionQueryMembershipRule
Rimuovere una regola di appartenenza alle query da un dispositivo o da una raccolta di utenti.
Sintassi
Remove-CMCollectionQueryMembershipRule
-InputObject <IResultObject>
-RuleName <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMCollectionQueryMembershipRule
-CollectionName <String>
-RuleName <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMCollectionQueryMembershipRule
-CollectionId <String>
-RuleName <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Utilizzare questo cmdlet per rimuovere una regola di appartenenza alle query da un dispositivo o da una raccolta di utenti.
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 rimuovere le regole di query dagli insiemi predefiniti. 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.
Quando si rimuove una regola di appartenenza a una query da una raccolta, è possibile che più risorse non siano più membri della raccolta. Questa azione può causare la non applicazione di qualsiasi distribuzione software o di configurazione alle risorse.
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: rimuovere le regole di appartenenza alle query per una raccolta di dispositivi
Questo comando rimuove la regola di appartenenza alla query denominata TPM dalla raccolta di dispositivi denominata Windows 10 dispositivi.
Remove-CMCollectionQueryMembershipRule -CollectionName "Windows 10 devices" -RuleName "TPM" -Force
Parametri
-CollectionId
Specificare l'ID della raccolta per rimuovere la regola. Questo valore è la proprietà CollectionID, ad esempio XYZ00012
. Poiché non è possibile rimuovere le regole di query dalle raccolte predefinite, questo ID inizia con il codice del sito e non con SMS
.
Type: | String |
Aliases: | Id |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
Specificare il nome della raccolta per rimuovere la regola.
Type: | String |
Aliases: | Name |
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 |
-Force
Eseguire il comando senza chiedere conferma.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Specificare un oggetto per l'insieme per rimuovere la regola. Per ottenere questo oggetto, utilizzare i cmdlet Get-CMCollection, Get-CMDeviceCollectiono Get-CMUserCollection.
Type: | IResultObject |
Aliases: | Collection |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RuleName
Specificare il nome della regola di query da rimuovere dall'insieme.
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
Note
Questo cmdlet è simile a Remove-CMDeviceCollectionQueryMembershipRule e Remove-CMUserCollectionQueryMembershipRule, che sono specifici del tipo di raccolta. Questo cmdlet funziona con le raccolte di dispositivi o utenti.
Collegamenti correlati
- Get-CMCollectionQueryMembershipRule
- Remove-CMCollectionDirectMembershipRule
- Remove-CMCollectionExcludeMembershipRule
- Remove-CMCollectionIncludeMembershipRule
- Add-CMDeviceCollectionQueryMembershipRule
- Add-CMUserCollectionQueryMembershipRule
- Get-CMDeviceCollectionQueryMembershipRule
- Get-CMUserCollectionQueryMembershipRule
- Get-CMCollection
- Get-CMDeviceCollection
- Get-CMUserCollection
- Come creare raccolte in Configuration Manager