Remove-CMDeviceCollectionIncludeMembershipRule

Riferimento

Modulo:: ConfigurationManager

Rimuovere una regola di appartenenza di inclusione da una raccolta di dispositivi.

Sintassi

Remove-CMDeviceCollectionIncludeMembershipRule
      -CollectionName <String>
      -IncludeCollectionName <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMDeviceCollectionIncludeMembershipRule
      -CollectionName <String>
      -IncludeCollection <IResultObject>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMDeviceCollectionIncludeMembershipRule
      -CollectionName <String>
      -IncludeCollectionId <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMDeviceCollectionIncludeMembershipRule
      -CollectionId <String>
      -IncludeCollection <IResultObject>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMDeviceCollectionIncludeMembershipRule
      -CollectionId <String>
      -IncludeCollectionId <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMDeviceCollectionIncludeMembershipRule
      -CollectionId <String>
      -IncludeCollectionName <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMDeviceCollectionIncludeMembershipRule
      -InputObject <IResultObject>
      -IncludeCollection <IResultObject>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMDeviceCollectionIncludeMembershipRule
      -InputObject <IResultObject>
      -IncludeCollectionId <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMDeviceCollectionIncludeMembershipRule
      -InputObject <IResultObject>
      -IncludeCollectionName <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Descrizione

Utilizzare questo cmdlet per rimuovere una regola di inclusione di appartenenza da una raccolta di dispositivi. Una regola di appartenenza include i membri di un'altra raccolta nelle raccolte di dispositivi in cui viene applicata la regola.

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

Quando rimuovi una regola di inclusione di appartenenza a una raccolta, una risorsa potrebbe non essere più un membro della raccolta di dispositivi. Questa azione può causare la non applicazione a un dispositivo di qualsiasi distribuzione di software o configurazione.

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 Device. Se si specifica il parametro Force, la regola di appartenenza verrà rimossa senza richiedere conferma.

Remove-CMDeviceCollectionIncludeMembershipRule -CollectionName "Device" -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 dispositivi denominato Device. Viene quindi utilizzato l'operatore della pipeline per passare l'oggetto al cmdlet Remove-CMDeviceCollectionIncludeMembershipRule.

Get-CMCollection -Name "Device" | Remove-CMDeviceCollectionIncludeMembershipRule -IncludeCollectionName "All Systems" -Force

Parametri

-CollectionId

Specifica l'ID della raccolta di dispositivi 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

Specifica il nome della raccolta di dispositivi 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:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

Forza l'esecuzione del comando senza richiedere la conferma dell'utente.

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 o Get-CMDeviceCollection.

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 di dispositivi per rimuovere la regola. Per ottenere questo oggetto, utilizzare i cmdlet Get-CMCollection o Get-CMDeviceCollection.

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:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object