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 Configuration Manager cmdlet dall'unità del sito 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 , con ID SMSDM001, dall'ID della raccolta di 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 .

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

-CollectionName

Specificare il nome della raccolta di dispositivi per aggiungere la regola.

Type:String
Aliases:Name
Position:Named
Default value:None
Required:True
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
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

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

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

-ExcludeCollectionName

Specificare il nome della raccolta esclusa per aggiungere la regola.

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

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

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

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object