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

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

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

Quando si rimuove una regola di inclusione di appartenenza a una raccolta, una risorsa potrebbe non essere più un membro della raccolta. Questa azione può causare la non 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 ulteriori informazioni, vedere Introduzione.

Esempio

Esempio 1: Rimuovere una regola di appartenenza di inclusione

Questo comando rimuove la regola di appartenenza include per l'insieme All Systems dalla raccolta di dispositivi denominata Devices. Se si specifica il parametro Force, la regola di appartenenza verrà rimossa senza richiedere conferma.

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

Esempio 2: Rimuovere una regola di appartenenza di inclusione tramite la pipeline

Questo comando utilizza innanzitutto il cmdlet Get-CMCollection per ottenere l'oggetto insieme di utenti denominato Users. Viene quindi utilizzato 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 SMS con .

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

-IncludeCollection

Specificare un oggetto per l'insieme incluso per rimuovere la regola. Per ottenere questo oggetto, utilizzare i cmdlet Get-CMCollection, Get-CMDeviceCollectiono Get-CMUserCollection.

Type:	IResultObject
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	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 .

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-IncludeCollectionName

Specificare il nome della raccolta inclusa per rimuovere la regola.

Type:	String
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

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