Condividi tramite

Remove-CMUserCollectionQueryMembershipRule

  • Riferimento
Modulo:
ConfigurationManager

Rimuovere una regola di appartenenza alle query da una raccolta di utenti.

Sintassi

Remove-CMUserCollectionQueryMembershipRule
      -InputObject <IResultObject>
      -RuleName <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMUserCollectionQueryMembershipRule
      -CollectionName <String>
      -RuleName <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMUserCollectionQueryMembershipRule
      -CollectionId <String>
      -RuleName <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Descrizione

Usare questo cmdlet per rimuovere una regola di appartenenza alle query da una raccolta di 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 di software o configurazione agli utenti.

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 una regola da una raccolta usando il nome della raccolta

Questo comando rimuove la regola denominata Remote Users by Domain dalla raccolta denominata Remote Users.

Remove-CMUserCollectionQueryMembershipRule -CollectionName "Remote Users" -RuleName "Remote Users by Domain"

Parametri

-CollectionId

Specificare l'ID della raccolta utenti 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 utenti 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:False
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 di dispositivi per rimuovere la regola. Per ottenere questo oggetto, usare i cmdlet Get-CMCollection 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:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object