Condividi tramite

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

Usare questo cmdlet per rimuovere una regola di appartenenza diretta da una raccolta di dispositivi o utenti. Una regola di appartenenza diretta consente di scegliere in modo esplicito i membri della raccolta. Le raccolte predefinite non hanno regole di appartenenza diretta. 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 diretta da una raccolta, la risorsa potrebbe non essere più un membro della raccolta. Questa azione può causare la mancata 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 altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Rimuovere il computer locale da una raccolta di dispositivi di test

In questo esempio viene utilizzata la variabile di ambiente Windows ComputerName per rimuoverla dalla raccolta denominata Dispositivi di test. Usa 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".

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 con la regola diretta da rimuovere.

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

-InputObject

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

-Resource

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

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

-ResourceId

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

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

-ResourceName

Specificare una matrice di nomi di risorse da rimuovere dalla raccolta.

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

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