Condividi tramite

Remove-CMCollectionIncludeMembershipRule

  • Riferimento
Modulo:
ConfigurationManager

Rimuovere una regola di appartenenza di inclusione da un dispositivo o da una raccolta di utenti.

Sintassi

Remove-CMCollectionIncludeMembershipRule
      -CollectionName <String>
      -IncludeCollectionName <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionIncludeMembershipRule
      -CollectionName <String>
      -IncludeCollection <IResultObject>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionIncludeMembershipRule
      -CollectionName <String>
      -IncludeCollectionId <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionIncludeMembershipRule
      -CollectionId <String>
      -IncludeCollection <IResultObject>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionIncludeMembershipRule
      -CollectionId <String>
      -IncludeCollectionId <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionIncludeMembershipRule
      -CollectionId <String>
      -IncludeCollectionName <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionIncludeMembershipRule
      -InputObject <IResultObject>
      -IncludeCollection <IResultObject>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionIncludeMembershipRule
      -InputObject <IResultObject>
      -IncludeCollectionId <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionIncludeMembershipRule
      -InputObject <IResultObject>
      -IncludeCollectionName <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Descrizione

Usare questo cmdlet per rimuovere una regola di appartenenza all'inclusione da una raccolta di dispositivi o utenti. Una regola di appartenenza include i membri di un'altra raccolta nella raccolta in cui viene applicata la regola.

Per altre informazioni, vedere Come creare raccolte in Configuration Manager.

Quando si rimuove una regola di appartenenza all'inclusione in una raccolta, una risorsa potrebbe non essere più membro della raccolta. Questa azione può causare la mancata applicazione di qualsiasi distribuzione di software o configurazione a una risorsa.

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 di appartenenza all'inclusione

Questo comando rimuove la regola di appartenenza di inclusione per la raccolta Tutti i sistemi dalla raccolta di dispositivi denominata Dispositivi. Se si specifica il parametro Force , la regola di appartenenza viene rimossa senza richiedere conferma.

Remove-CMCollectionIncludeMembershipRule -CollectionName "Devices" -IncludeCollectionName "All Systems" -Force

Esempio 2: Rimuovere una regola di appartenenza all'inclusione usando la pipeline

Questo comando usa innanzitutto il cmdlet Get-CMCollection per ottenere l'oggetto raccolta utente denominato Users. Usa quindi l'operatore della pipeline per passare l'oggetto al cmdlet Remove-CMCollectionIncludeMembershipRule .

Get-CMCollection -Name "Users" | Remove-CMCollectionIncludeMembershipRule -IncludeCollectionName "All Users" -Force

Parametri

-CollectionId

Specificare l'ID della raccolta per rimuovere la regola. Questo valore è la proprietà CollectionID , ad esempio XYZ00012. Poiché le raccolte predefinite non includono regole di appartenenza, 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

-IncludeCollection

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

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

-IncludeCollectionId

Specificare l'ID della raccolta inclusa per rimuovere la regola. Questo valore è la proprietà CollectionID , ad esempio XYZ00012. È possibile includere raccolte predefinite, in modo che questo valore possa iniziare con il codice del sito o SMS.

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

-IncludeCollectionName

Specificare il nome della raccolta inclusa per rimuovere la regola.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
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

-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-CMDeviceCollectionIncludeMembershipRule e Remove-CMUserCollectionIncludeMembershipRule, specifici del tipo di raccolta. Questo cmdlet funziona con le raccolte di dispositivi o utenti.