Remove-CMCollectionDirectMembershipRule

Riferimento

Modulo:: ConfigurationManager

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

Sintassi

Remove-CMCollectionDirectMembershipRule
      -CollectionName <String>
      -ResourceName <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMCollectionDirectMembershipRule
      -CollectionName <String>
      -Resource <IResultObject[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMCollectionDirectMembershipRule
      -CollectionName <String>
      -ResourceId <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMCollectionDirectMembershipRule
      -CollectionId <String>
      -Resource <IResultObject[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMCollectionDirectMembershipRule
      -CollectionId <String>
      -ResourceId <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMCollectionDirectMembershipRule
      -CollectionId <String>
      -ResourceName <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMCollectionDirectMembershipRule
      -InputObject <IResultObject>
      -Resource <IResultObject[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMCollectionDirectMembershipRule
      -InputObject <IResultObject>
      -ResourceId <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMCollectionDirectMembershipRule
      -InputObject <IResultObject>
      -ResourceName <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Descrizione

Utilizzare questo cmdlet per rimuovere una regola di appartenenza diretta da un dispositivo o da una raccolta di utenti. Una regola di appartenenza diretta consente di scegliere esplicitamente i membri della raccolta. Le raccolte predefinite non dispongono di regole di appartenenza diretta. Qualsiasi raccolta di destinazione deve avere un ID che inizia con il codice del sito, non SMS . Per ulteriori informazioni, vedere Come creare raccolte in Configuration Manager.

Quando si rimuove una regola di appartenenza diretta da una raccolta, la risorsa potrebbe non essere più un membro della raccolta. Questa azione può causare la non applicazione di qualsiasi distribuzione software o di configurazione alla 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 il computer locale da una raccolta di dispositivi di test

In questo esempio viene utilizzata Windows variabile di ambiente ComputerName per rimuoverla dall'insieme denominato Test Devices. Viene utilizzato il parametro Force per non richiedere conferma.

Remove-CMCollectionDirectMembershipRule -CollectionName 'Test Devices' -ResourceName $env:ComputerName -Force

Parametri

-CollectionId

Specificare l'ID della raccolta con la regola diretta da rimuovere. Ad esempio, "XYZ0003F".

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

-CollectionName

Specificare il nome della raccolta con la regola diretta da rimuovere.

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

-InputObject

Specificare un oggetto insieme con la regola diretta da rimuovere. 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

-Resource

Specificare una matrice di oggetti risorsa da rimuovere dall'insieme. Per ottenere questo oggetto, utilizzare i cmdlet Get-CMResource, Get-CMDeviceo Get-CMUser.

Type:	IResultObject[]
Aliases:	Resources
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceId

Specificare una matrice di ID risorsa da rimuovere dalla raccolta. Questo valore è la proprietà ResourceId della SMS_Resource classe. Ad esempio, "33555693".

Type:	String[]
Aliases:	ResourceIds
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceName

Specificare una matrice di nomi di risorse da rimuovere dall'insieme.

Type:	String[]
Aliases:	ResourceNames
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	True

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