Add-CMUserCollectionExcludeMembershipRule

Riferimento

Modulo:: ConfigurationManager

Aggiungere una regola di appartenenza di esclusione a una raccolta utenti.

Sintassi

Add-CMUserCollectionExcludeMembershipRule
   -CollectionName <String>
   -ExcludeCollectionName <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMUserCollectionExcludeMembershipRule
   -CollectionName <String>
   -ExcludeCollection <IResultObject>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMUserCollectionExcludeMembershipRule
   -CollectionName <String>
   -ExcludeCollectionId <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMUserCollectionExcludeMembershipRule
   -CollectionId <String>
   -ExcludeCollection <IResultObject>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMUserCollectionExcludeMembershipRule
   -CollectionId <String>
   -ExcludeCollectionId <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMUserCollectionExcludeMembershipRule
   -CollectionId <String>
   -ExcludeCollectionName <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMUserCollectionExcludeMembershipRule
   -InputObject <IResultObject>
   -ExcludeCollection <IResultObject>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMUserCollectionExcludeMembershipRule
   -InputObject <IResultObject>
   -ExcludeCollectionId <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMUserCollectionExcludeMembershipRule
   -InputObject <IResultObject>
   -ExcludeCollectionName <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Utilizzare questo cmdlet per aggiungere una regola di appartenenza di esclusione a una raccolta di utenti. Una regola di appartenenza di esclusione esclude i membri di un'altra raccolta dalle raccolte utenti 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 SMS . È possibile escludere una raccolta predefinita, in modo che l'ID di una raccolta esclusa possa iniziare con SMS .

Configuration Manager aggiorna dinamicamente l'appartenenza della raccolta utenti in base a una pianificazione se l'appartenenza della raccolta esclusa cambia.

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

Per ulteriori 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 ulteriori informazioni, vedere Introduzione.

Esempio

Esempio 1: Aggiungere una regola di esclusione della raccolta a una raccolta utenti

Questo comando esclude i membri dell'insieme Remote Users, con ID XYZ00017, dall'insieme di utenti con ID XYZ00012.

Add-CMUserCollectionExcludeMembershipRule -CollectionId "XYZ00012" -ExcludeCollectionId "XYZ00017"

Parametri

-CollectionId

Specificare l'ID della raccolta utenti per aggiungere la regola. Questo valore è la proprietà CollectionID, ad esempio XYZ00012 . Poiché le raccolte predefinite non dispongono di regole di appartenenza di esclusione, 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

Specificare il nome della raccolta utenti per aggiungere 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

-ExcludeCollection

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

Type:	IResultObject
Position:	Named
Default value:	None
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 inizi con il codice del sito o SMS .

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

-InputObject

Specificare un oggetto per l'insieme di utenti per aggiungere la regola. Per ottenere questo oggetto, utilizzare i cmdlet Get-CMCollection o Get-CMUserCollection.

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

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object