Condividi tramite

Remove-CMCollectionQueryMembershipRule

  • Riferimento
Modulo:
ConfigurationManager

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

Usare questo cmdlet per rimuovere una regola di appartenenza alle query da una raccolta di dispositivi o utenti. Una regola di query consente di aggiornare dinamicamente l'appartenenza a una raccolta in base a una query eseguita in base a una pianificazione. Non è possibile rimuovere le regole di query dalle raccolte predefinite. Qualsiasi raccolta di destinazione deve avere un ID che inizia con il codice del sito, non SMScon . Per altre informazioni, vedere Come creare raccolte in Configuration Manager.

Quando si rimuove una regola di appartenenza alla query da una raccolta, più risorse potrebbero non essere più membri della raccolta. Questa azione può causare la mancata 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 altre 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 Dispositivi Windows 10.

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 SMScon .

Tipo:String
Alias:Id
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CollectionName

Specificare il nome della raccolta per rimuovere la regola.

Tipo:String
Alias:Name
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Force

Eseguire il comando senza richiedere conferma.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Specificare un oggetto per la raccolta per rimuovere la regola. Per ottenere questo oggetto, usare i cmdlet Get-CMCollection, Get-CMDeviceCollection o Get-CMUserCollection .

Tipo:IResultObject
Alias:Collection
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-RuleName

Specificare il nome della regola di query da rimuovere dalla raccolta.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object

Note

Questo cmdlet è simile a Remove-CMDeviceCollectionQueryMembershipRule e Remove-CMUserCollectionQueryMembershipRule, specifici del tipo di raccolta. Questo cmdlet funziona con le raccolte di dispositivi o utenti.