Condividi tramite

Add-CMDeviceCollectionExcludeMembershipRule

  • Riferimento
Modulo:
ConfigurationManager

Aggiungere una regola di esclusione dell'appartenenza a una raccolta di dispositivi.

Sintassi

Add-CMDeviceCollectionExcludeMembershipRule
   -CollectionName <String>
   -ExcludeCollectionName <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionExcludeMembershipRule
   -CollectionName <String>
   -ExcludeCollection <IResultObject>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionExcludeMembershipRule
   -CollectionName <String>
   -ExcludeCollectionId <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionExcludeMembershipRule
   -CollectionId <String>
   -ExcludeCollection <IResultObject>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionExcludeMembershipRule
   -CollectionId <String>
   -ExcludeCollectionId <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionExcludeMembershipRule
   -CollectionId <String>
   -ExcludeCollectionName <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionExcludeMembershipRule
   -InputObject <IResultObject>
   -ExcludeCollection <IResultObject>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionExcludeMembershipRule
   -InputObject <IResultObject>
   -ExcludeCollectionId <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionExcludeMembershipRule
   -InputObject <IResultObject>
   -ExcludeCollectionName <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Usare questo cmdlet per aggiungere una regola di esclusione di appartenenza a una raccolta di dispositivi. Una regola di esclusione dell'appartenenza esclude i membri di un'altra raccolta dalle raccolte di dispositivi in cui viene applicata la regola.

Non è possibile aggiungere regole di appartenenza alle raccolte predefinite. Qualsiasi raccolta di destinazione deve avere un ID che inizia con il codice del sito, non SMScon . È possibile escludere una raccolta predefinita, in modo che l'ID di una raccolta esclusa possa iniziare con SMS.

Configuration Manager aggiorna dinamicamente l'appartenenza alla raccolta di dispositivi in base a una pianificazione se cambia l'appartenenza alla raccolta esclusa.

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

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

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: Aggiungere una regola di esclusione della raccolta a una raccolta di dispositivi

Questo comando esclude i membri della raccolta predefinita Tutti i dispositivi mobili , che ha l'ID SMSDM001, dall'ID raccolta dispositivi XYZ00012.

Add-CMDeviceCollectionExcludeMembershipRule -CollectionId "XYZ00012" -ExcludeCollectionId "SMSDM001"

Parametri

-CollectionId

Specificare l'ID della raccolta di dispositivi per aggiungere la regola. Questo valore è la proprietà CollectionID , ad esempio XYZ00012. Poiché le raccolte predefinite non includono regole di appartenenza escluse, 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 di dispositivi per aggiungere 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:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ExcludeCollection

Specificare un oggetto per l'insieme escluso per aggiungere la regola. Per ottenere questo oggetto, usare i cmdlet Get-CMCollection o Get-CMDeviceCollection .

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

-ExcludeCollectionId

Specificare l'ID della raccolta esclusa per aggiungere la regola. Questo valore è la proprietà CollectionID , ad esempio XYZ00012. È possibile escludere le 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

-ExcludeCollectionName

Specificare il nome della raccolta esclusa per aggiungere 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 di dispositivi per aggiungere la regola. Per ottenere questo oggetto, usare i cmdlet Get-CMCollection o Get-CMDeviceCollection .

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

-PassThru

Aggiungere questo parametro per restituire un oggetto che rappresenta l'elemento con cui si sta lavorando. Per impostazione predefinita, questo cmdlet potrebbe non generare alcun output.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
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:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object